API การเช่าเลขหมายโทรศัพท์

เช่าเลขหมาย อ่านข้อความที่เข้ามา ขยายเวลาและยกเลิกจากโค้ดของคุณเอง JSON ผ่าน HTTPS ด้วยคีย์ API เดียวจากคอนโซล

URL หลัก: https://snsnumber.com/api/v1
การยืนยันตัวตน: Authorization: Bearer snk_...
อัตราการเรียกใช้: 300 คำขอต่อนาทีต่อคีย์

สร้างคีย์ในคอนโซลภายใต้ API ราคาเป็นดอลลาร์สหรัฐในรูปแบบสตริงทศนิยมสองตำแหน่ง เวลาเป็น ISO 8601 ใน UTC

จุดปลายทาง

GET/balanceเครดิตของคุณในดอลลาร์สหรัฐ

{ "balance": "120.00", "currency": "USD" }

GET/prices?country=usประเทศ ระยะเวลาและราคา ละเว้นประเทศเพื่อแสดงทั้งหมด

{ "currency": "USD", "countries": [ { "country": "us", "name": "United States", "dial": "+1",
  "periods": [ { "days": 15, "price": "36.00" }, { "days": 30, "price": "54.00" } ] } ] }

POST/rentalsเช่าเลขหมาย เนื้อหา: ประเทศและวัน

curl -X POST https://snsnumber.com/api/v1/rentals -H "Authorization: Bearer snk_..." \
  -H "Content-Type: application/json" -d '{"country":"us","days":30}'

{ "rental": { "id": "RN-7KQ2M9XWD4", "country": "us", "phone": "+14155550123", "state": "active",
  "days": 30, "ends_at": "2026-12-03T10:00:00.000Z", "can_cancel": true, "messages": [] } }

GET/rentals?state=activeการเช่าของคุณ เรียงจากใหม่ล่าสุด (สถานะ: ใช้งานอยู่, หมดอายุ, ยกเลิก)

{ "rentals": [ { "id": "RN-7KQ2M9XWD4", "phone": "+14155550123", "state": "active", "message_count": 2 } ] }

GET/rentals/{id}การเช่าหนึ่งรายการพร้อมกล่องข้อความเข้า

{ "rental": { "id": "RN-7KQ2M9XWD4", "messages": [ { "id": 18, "sender": "Verify",
  "text": "Your verification code is 482913.", "code": "482913", "received_at": "2026-11-03T10:01:12.000Z" } ] } }

POST/rentals/{id}/extendเพิ่มระยะเวลาให้กับการเช่าที่ใช้งานอยู่ เนื้อหา: วัน

{"days":15}  ->  { "rental": { "id": "RN-7KQ2M9XWD4", "extensions": 1, "ends_at": "2026-12-18T10:00:00.000Z" } }

POST/rentals/{id}/cancelคืนเงินเต็มจำนวนภายใน 20 นาที หากยังไม่ได้รับ SMS

{ "rental": { "id": "RN-7KQ2M9XWD4", "state": "canceled" } }

ข้อผิดพลาด

ข้อผิดพลาดจะส่งกลับสถานะ HTTP และ { "error": { "code", "message" } }

สถานะ	รหัส	ความหมาย
401	no_key, bad_key	ขาดหรือผิด API key
402	no_balance	เครดิตไม่เพียงพอ
404	not_found	ไม่พบการเช่า
409	ended, cancel_denied	การเช่าหมดอายุ หรือหน้าต่างการยกเลิกผ่านไปแล้ว
429	rate_limited, too_many_active	300 คำขอต่อนาที หรือ 20 หมายเลขที่ใช้งานอยู่
503	network_error	ลองอีกครั้งในไม่ช้า