เอกสาร

ส่งข้อความแรกของคุณ ในช่วงบ่าย

REST API ธรรมดาสำหรับการส่ง ติดตาม และรับ SMS — การตรวจสอบโทเค็น เว็บฮุคแบบเรียลไทม์ และ SDK โดยไม่มีอะไรแปลกใหม่ให้เรียนรู้

เริ่มต้นอย่างรวดเร็ว

สามกระบวนท่า เริ่มส่งมอบแล้ว

การรวมทุกอย่างมีเนื้อหาสั้นๆ เหมือนกัน — รับรองความถูกต้อง ส่ง และติดตาม

01 · ตรวจสอบสิทธิ์โทเค็น: sk_live_9f2a7c10ประเภทเนื้อหา: application/json ✓

ส่งคีย์การเข้าถึงของคุณเป็นส่วนหัว Token พร้อมด้วย Content-Type: application/json ในทุกคำขอ

02 · ส่งโพสต์ /ภายนอก/sms{ msgid: "9f2a7c10", รหัสข้อผิดพลาด: 0 }

โพสต์จากถึงและเนื้อหา การตอบสนองกลับมาพร้อมกับ msgid และรหัสข้อผิดพลาดทันที

03 · ติดตามGET /report?status=Delivrd200 โอเค

เราโพสต์หรือรับรายงานสถานะไปยัง URL โทรกลับของคุณทันทีที่ข้อความถึงสถานะสุดท้าย

ส่ง

หนึ่งคำขอในภาษาที่คุณใช้อยู่แล้ว

โพสต์ผู้ส่ง ผู้รับ และเนื้อหาของคุณด้วยส่วนหัว Token การตอบสนองจะกลับมาทันทีที่เรายอมรับมัน

01curl -X POST https://secure.smslocal.com/api/service/enterprise-service/external/sms \02  -H "Token: $SMSLOCAL_TOKEN" \03  -H "Content-Type: application/json" \04  -d '{05    "from": "SMSLOCAL",06    "to": "14155550123",07    "content": "Your code is 481920."08  }'
201 · ยอมรับแล้ว

msgstr "9f2a7c10-4b2e-…"

ทิศทาง "ภูเขา"

รหัสข้อผิดพลาด 0

บันทึก msgstr — นี่คือวิธีที่คุณติดตามข้อความนี้จากที่นี่

วัตถุข้อความ

อ่านข้อความจากบนลงล่าง

เหตุการณ์การส่ง สถานะ และขาเข้าทั้งหมดกลับมามีรูปร่างเหมือนเดิม — เรียนรู้เพียงครั้งเดียว

01รหัสข้อความ

รหัสข้อความ

msgid — สร้างทันทีที่มีการสร้างข้อความ นี่คือหมายเลขอ้างอิงที่คุณใช้เพื่อตรวจสอบสถานะในภายหลัง

02ผู้ส่ง

ผู้ส่ง

จาก — หมายเลขโทรศัพท์ หรือ ID ตัวอักษรและตัวเลขยาวสูงสุด 11 อักขระ แล้วแต่ว่าผู้รับของคุณจะเห็นข้อมูลประจำตัวใด

03ผู้รับ

ผู้รับ

ถึง — หมายเลขที่ข้อความจะไป รวมถึงรหัสประเทศด้วย

04การเข้ารหัส

การเข้ารหัส

การเข้ารหัสข้อมูล — GSM7 เหมาะกับ 160 ตัวอักษรต่อส่วน เปลี่ยนเป็น Unicode และลดลงเหลือ 70 ข้ามไปและต่อเป็นส่วนที่เรียกเก็บเงินเพิ่มเติม

05ทิศทาง

ทิศทาง

ทิศทาง — ทุกข้อความคือ mt (คุณส่งไป) หรือ mo (คุณได้รับ) มีรูปร่างเหมือนกันไม่ว่าจะด้วยวิธีใด

06รหัสข้อผิดพลาด

รหัสข้อผิดพลาด

รหัสข้อผิดพลาด — ส่งคืนในการตอบกลับการส่งและทุกรายงานสถานะ 0 หมายถึง ยอมรับ; สิ่งอื่นใดที่บอกคุณได้อย่างชัดเจนว่าเกิดอะไรขึ้น

อ้างอิง

หนึ่งจุดสิ้นสุด สองกริยา

POST เพื่อส่ง GET เพื่อตรวจสอบสถานะ - URL เดียวกันและส่วนหัว Token เดียวกันไม่ว่าจะด้วยวิธีใด

โพสต์

ส่ง

ส่งข้อความและรับ msgid และรหัสข้อผิดพลาดกลับคืนทันที

การส่งคืน msgstr + รหัสข้อผิดพลาด
รับ

ติดตาม

ค้นหาข้อความที่คุณส่งไปแล้วเพื่อตรวจสอบสถานะปัจจุบัน

การส่งคืน ข้อความ + สถานะ
เว็บฮุค

รายงานสถานะทันทีที่เกิดขึ้น

ตั้งค่า URL ติดต่อกลับ แล้วการส่งมอบ ความล้มเหลว และการตอบกลับขาเข้าทุกครั้งจะไปถึงที่นั่นในรูปแบบ GET หรือ POST โดยไม่จำเป็นต้องทำการโพล

จัดส่งแล้วmsgid 9f2a7c10 · สถานะ ส่งมอบ
ขาเข้าได้รับการตอบกลับ·ทิศทางโม
ล้มเหลวmsgstr 4c81e2 · สถานะล้มเหลว
จุดสิ้นสุดของคุณ200 โอเค
เริ่มต้นเลย

รับคีย์ API ของคุณ

เริ่มบูรณาการกับ REST API ของเราในไม่กี่นาที

คำตอบสำหรับคำถามของคุณ

เอกสารสำหรับนักพัฒนา — คำถามที่ถูกถามบ่อย

ส่งคีย์การเข้าถึงของคุณในส่วนหัว Token ในทุกคำขอ — โทเค็น: {accessKey} — พร้อมด้วย Content-Type: application/json

ทุกการส่งคืนค่า msgid ชี้ให้เราไปที่ URL การติดต่อกลับ แล้วเราจะโพสต์หรือรับรายงานสถานะทันทีที่ข้อความถึงสถานะสุดท้าย รวมถึงวันที่ย่อย วันที่เสร็จสิ้น และรหัสสถานะผลลัพธ์ที่รวมอยู่ด้วย

mt (ยุติการใช้งานมือถือ) คือข้อความที่คุณส่ง mo (มาจากมือถือ) เป็นการตอบกลับที่คุณได้รับ ทั้งสองใช้รูปร่างวัตถุข้อความเดียวกัน

การนำส่งจะถูกลองใหม่ตามนโยบายการลองใหม่ - ไม่มีการดรอปใดๆ โดยไม่แจ้งให้ทราบ แต่ปลายทางที่ไม่เคยรับทราบจะยังคงรับการลองใหม่ต่อไป

160 อักขระในการเข้ารหัส GSM7 หรือ 70 ตัวใน Unicode เกินขีดจำกัดแล้วข้อความจะต่อกันเป็นหลายส่วน โดยแต่ละส่วนจะเรียกเก็บเงินแยกกัน