ดึงรหัสยืนยันของอาร์เจนตินา (+54) เข้าสู่ระบบเชื่อมต่อของคุณ

API สี่การเรียกเบื้องหลังการ activate เบอร์ +54 คืออะไรบ้าง?

ทุกอย่างอยู่ภายใต้ https://otproute.com/api/v1 และยืนยันตัวตนด้วยคีย์ Bearer ที่ขึ้นต้นด้วย or_live_ คีย์ออกให้ใน Developer console หนึ่งบัญชีมีได้ 10 คีย์และลงทะเบียนเว็บฮุกได้ 5 endpoint โดยมีเพดาน 300 คำขอต่อนาที

1. ขอราคา เรียก GET /api/v1/prices?country=ar&service=<id> เพื่อให้โค้ดของคุณรู้ต้นทุนสดก่อนใช้เงินในกระเป๋า country id ของอาร์เจนตินาคือ ar
2. สั่งซื้อ ส่ง POST /api/v1/activations พร้อม JSON {"service": "whatsapp", "country": "ar"} โดยเปลี่ยนเป็น service id ที่การทดสอบของคุณต้องการ ผลตอบกลับมี activation id และเบอร์ +54 ที่ต้องพิมพ์ลงในแอปที่ทดสอบ
3. รอรหัส อ่าน GET /api/v1/activations/{id} ตามช่วงเวลาที่เหมาะสม หรือให้เว็บฮุก activation.sms_received แจ้งว่ารหัสเข้ามาแล้ว
4. ปล่อยก่อนกำหนดหากจำเป็น POST /api/v1/activations/{id}/cancel ยุติ activation ที่คุณไม่ต้องการและคืนเงินเข้ากระเป๋า

หากต้องการดู id ก่อนฮาร์ดโค้ด GET /api/v1/services และ GET /api/v1/countries จะแสดงสิ่งที่แพลตฟอร์มมีให้ในขณะนั้น เอกสารอ้างอิงฉบับเต็มอยู่ในเอกสาร

จะทำให้ตัวรับเว็บฮุกน่าเชื่อถือสำหรับรหัสของอาร์เจนตินาได้อย่างไร?

ทุกการส่งมีเฮดเดอร์ X-OTPRoute-Signature รูปแบบ t=<unix>,v1=<hex> ให้สร้างสตริง "<t>.<raw body>" ขึ้นใหม่ คำนวณ HMAC-SHA256 ด้วย secret ของ endpoint นั้น แล้วเปรียบเทียบผลลัพธ์กับ v1 ด้วยฟังก์ชันแบบ constant-time ทิ้งคำขอใดก็ตามที่ timestamp เก่าเกินไป เพราะลายมือชื่อเก่าแต่ถูกต้องคือสิ่งที่การโจมตีแบบ replay มีหน้าตาเช่นนั้น

นอกจาก activation.sms_received ควรสมัครรับ activation.expired และ activation.cancelled ด้วย เพื่อให้ตัวรันการทดสอบไม่ค้างรอเบอร์ที่ปิดไปแล้ว ถือว่าทุกเหตุการณ์อ้างอิงกับ activation id และเขียน handler ให้การส่งเหตุการณ์เดิมซ้ำเป็นครั้งที่สองไม่ทำให้อะไรเปลี่ยนแปลง บทความเรื่องการลงลายมือชื่อและตรวจสอบเว็บฮุก OTP อธิบายตรรกะการเปรียบเทียบอย่างละเอียดยิ่งขึ้น

แอปใดบ้างที่ยืนยันกับเบอร์อาร์เจนตินาได้?

สแนปช็อตสดของอาร์เจนตินามีบริการมากกว่า 2,000 รายการ ที่ทีมผลิตภัณฑ์และ QA ในอาร์เจนตินามักเลือกใช้ ได้แก่

• การส่งข้อความ: WhatsApp, Telegram, Signal, Discord
• บัญชีและงานเอกสาร: Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI)
• โซเชียลและวิดีโอ: Instagram, TikTok
• การค้าและการเดินทาง: Amazon, Uber, Airbnb, Netflix

รายการนี้เปลี่ยนแปลงระหว่างวัน จึงเป็นเหตุผลที่ API รายงานความพร้อมใช้งานแบบสด แทนที่จะเป็นตารางตายตัว ให้ query GET /api/v1/services โดยคำนึงถึงประเทศ ar ก่อนที่งาน CI ที่ตั้งเวลาไว้จะเริ่ม และให้ล้มเหลวเร็วพร้อมข้อความชัดเจนหากบริการเป้าหมายของคุณหายไปชั่วคราว

ทำไมเบอร์มือถืออาร์เจนตินาจึงทำให้ validator ของเบอร์โทรสะดุด?

อาร์เจนตินามีแผนหมายเลขที่ผิดปกติที่สุดแห่งหนึ่งในภูมิภาค ภายในประเทศ ผู้คนเขียน trunk 0 นำหน้ารหัสพื้นที่ และสำหรับมือถือจะมี 15 นำหน้าเลขสมาชิก ดังนั้นมือถือในบัวโนสไอเรสอาจปรากฏเป็น 011 15 ตามด้วยเลขแปดหลัก ในรูปแบบ E.164 ระหว่างประเทศ ทั้งสองส่วนนั้นหายไป และมี 9 แทรกหลังรหัสประเทศทันที คือ +54 9 11 แล้วตามด้วยเลขสมาชิกแปดหลัก

ความแตกต่างนี้สำคัญสำหรับทุกคนที่เก็บเบอร์โทร ให้ทำทุกอย่างเป็น E.164 ก่อนบันทึก ตัด 0 และ 15 ออกตอนรับข้อมูล และเติม 9 สำหรับเบอร์มือถือ validator ที่ตรวจเพียงความยาวจะรับค่าแบบเบอร์บ้าน +54 11 ที่รับ SMS ไม่ได้ ใช้เบอร์ตามที่ API ส่งกลับมาทุกประการ แทนการจัดรูปแบบใหม่เอง

รหัสที่ส่งไปยังเบอร์อาร์เจนตินามักมาเป็นภาษาสเปน และมักมีวลีเช่น "Tu código es" รอบตัวเลข ให้แยกรหัสตัวเลขด้วยรูปแบบ pattern แทนการจับคู่ถ้อยคำ เพราะเทมเพลตเปลี่ยนได้ ทีมทดสอบที่นี่เมื่อเปิดตัวในละตินอเมริกา ตรวจข้อความสเปนแบบริโอพลาเทนเซ (รูปแบบ vos ของท้องถิ่นต่างจากสเปนในตำรา) ดำเนินงานระดับภูมิภาค หรือให้บริการชาวอาร์เจนตินาที่อยู่ต่างประเทศแต่ยังสมัครด้วยซิม +54

คนที่ไม่เขียนโค้ดสั่งเบอร์ +54 ได้หรือไม่?

ได้ เจ้าหน้าที่สนับสนุน ฝ่ายการเติบโต และเอเจนซีทำทุกอย่างจากเบราว์เซอร์ได้

1. สร้างบัญชีที่หน้าสมัครสมาชิกด้วยอีเมลและรหัส 6 หลัก หรือด้วยการลงชื่อเข้าใช้ Google
2. เติมเงินเข้ากระเป๋าเงิน
3. เปิด OTP Gateway เลือกอาร์เจนตินา แล้วเลือกบริการที่คุณกำลังทดสอบ
4. ตรวจราคาที่แสดง ยืนยัน และคัดลอกเบอร์ +54 ไปที่หน้ายืนยันของแอป
5. ดู activation รหัสจะปรากฏที่นั่นทันทีที่ได้รับ

แดชบอร์ดและ API ใช้กระเป๋าเงินและ activation ชุดเดียวกัน นักพัฒนาจึงรับช่วงเบอร์ที่เพื่อนร่วมทีมสั่งไว้ได้ด้วย activation id ของมัน

รหัสของอาร์เจนตินาไม่มา ต้องทำอย่างไรต่อ?

แต่ละ activation เปิดอยู่ 20 นาที หากไม่มีอะไรเข้า หรือคุณยกเลิกก่อน เงินเต็มจำนวนจะคืนเข้ากระเป๋าเงินโดยอัตโนมัติ เส้นทางที่เงียบจึงทำให้เสียเวลา ไม่ใช่เสียเงิน ความเร็วในการส่งขึ้นกับบริการและเส้นทาง จึงควรให้หน้าต่างเวลาได้โอกาสอย่างเหมาะสมก่อนตัดสินว่าล้มเหลว

จากนั้นลองไล่ตามรายการสั้น ๆ นี้

• ขอรหัสอีกครั้งจากในแอปหนึ่งครั้ง แล้วปล่อยให้หน้าต่างเดินต่อไป
• ลองใหม่ภายหลังในวัน หรือสั่งผ่านอีกเส้นทางสำหรับบริการเดียวกัน
• ยืนยันว่าบริการรับเบอร์เสมือนหรือไม่ บางบริการปฏิเสธ ซึ่งเป็นเหตุผลที่มีการคืนเงินอัตโนมัติ
• หลีกเลี่ยงการสั่งซ้ำแบบถี่ ๆ จาก CI ให้เพิ่ม back-off และเพดานจำนวนการลองใหม่

บทความเรื่องการลดการส่ง OTP ที่ล้มเหลวครอบคลุมรูปแบบอื่นสำหรับเส้นทางอาร์เจนตินา รักษาการทดสอบทุกครั้งให้อยู่ภายในข้อกำหนดของแต่ละบริการ และนโยบายการใช้งานที่ยอมรับได้ (Acceptable Use Policy) ของ OTP Route ก็มีผลด้วย

เราเก็บเบอร์อาร์เจนตินาไว้ได้หรือไม่ และชำระเงินอย่างไร?

ปัจจุบันไม่มีเบอร์ระยะยาวแบบสมัครใช้เองสำหรับอาร์เจนตินา หากทีมของคุณต้องการเบอร์ +54 ถาวร โปรดอีเมลถึง [email protected] และอธิบายกรณีการใช้งาน โดยขึ้นอยู่กับกฎระเบียบในพื้นที่ว่าจะจัดให้ได้หรือไม่ และไม่มีการรับประกัน Dedicated Virtual Numbers ซึ่งคุณเก็บไว้ตลอดช่วงที่ต่ออายุและส่งต่อ SMS ขาเข้าไปยังเว็บฮุกของคุณ เป็นผลิตภัณฑ์สำหรับสหรัฐอเมริกาและแคนาดา เริ่มต้น $1.95/month

การเรียกเก็บเงินใช้กระเป๋าเงิน USD แบบเติมเงินล่วงหน้าเพียงใบเดียว ไม่มีค่ารายเดือนและไม่ต้องเลือกแพ็กเกจ เติมเงินด้วยบัตรหรือ USDT/USDC และทุกการเติมเงินจะมีใบแจ้งหนี้ PDF ส่งทางอีเมล รายละเอียดอยู่ในหน้าราคา ก่อนใช้เงินจริง ให้ขอให้สลับบัญชีพัฒนาของคุณเป็น sandbox ซึ่งจะคืนเบอร์และรหัสจำลอง เพื่อให้คุณซ้อมโฟลว์ของอาร์เจนตินาทั้งหมดแบบครบวงจร

คำถามที่พบบ่อย

country id ของอาร์เจนตินาใน OTP Route API คืออะไร?

คือ ar ส่งในฟิลด์ country ของ POST /api/v1/activations และใน query string ของ GET /api/v1/prices

ต้องเติมเลข 9 เมื่อพิมพ์เบอร์ +54 ลงในแอปหรือไม่?

ใช้เบอร์ตามที่ OTP Route ส่งกลับมาทุกประการ ในฐานข้อมูลของคุณเอง ให้เก็บมือถืออาร์เจนตินาในรูปแบบ E.164 ซึ่งมี 9 หลัง +54 และตัด 0 และ 15 ภายในประเทศออก

การรับ SMS OTP ของอาร์เจนตินาราคาเท่าไร?

เริ่มต้นที่ $0.20 ต่อรหัส แตกต่างกันตามบริการ ตัวเลขที่แน่นอนส่งกลับจาก GET /api/v1/prices และแสดงก่อนที่คุณจะยืนยันคำสั่งซื้อ

ฉันทดสอบโฟลว์สมัครสมาชิกของแอปสำหรับอาร์เจนตินาโดยไม่มีซิมในประเทศได้หรือไม่?

ได้ สั่ง activation ของอาร์เจนตินาสำหรับแอปของคุณเองหรือบริการภายนอกที่อยู่ในการทดสอบ กรอกเบอร์ +54 แล้วอ่านรหัสในแดชบอร์ดหรือจากเว็บฮุกของคุณ

เบอร์ +54 เดิมใช้ล็อกอินอีกครั้งเดือนหน้าได้หรือไม่?

ไม่ได้ เบอร์ของ gateway ครอบคลุมรหัสเดียวภายใน 20 นาที สำหรับบัญชีที่ต้องรับรหัสต่อเนื่อง Dedicated Number ในสหรัฐฯ หรือแคนาดาเป็นตัวเลือกที่เหมาะ

ข้อความยืนยันของอาร์เจนตินาจะเป็นภาษาอะไร?

โดยทั่วไปเป็นภาษาสเปน แต่ขึ้นกับผู้ส่งและการตั้งค่าภาษาของบัญชี ให้ดึงตัวเลขออกมาแทนการพึ่งถ้อยคำรอบข้าง

ใช้ polling แทนเว็บฮุกได้หรือไม่?

ได้ โพล GET /api/v1/activations/{id} ด้วยช่วงเวลาพอประมาณ และให้อยู่ต่ำกว่าขีดจำกัด 300 คำขอต่อนาทีต่อบัญชีอย่างมาก

ชื่อบริการเป็นเครื่องหมายการค้าของเจ้าของนั้น ๆ OTP Route ไม่มีความเกี่ยวข้องกับบริการเหล่านั้น โปรดใช้หมายเลขอย่างถูกกฎหมาย และปฏิบัติตามข้อกำหนดของแต่ละบริการและนโยบายการใช้งานที่ยอมรับได้ของเรา