API para sa pag-upa ng phone number

Mag-renta ng mga numero, basahin ang mga papasok na SMS, mag-extend at mag-cancel mula sa iyong sariling code. JSON over HTTPS gamit ang isang API key mula sa console.

Base URL: https://snsnumber.com/api/v1
Authentication: Authorization: Bearer snk_...
Rate limit: 300 requests kada minuto kada key

Gumawa ng key sa console sa ilalim ng API. Ang mga presyo ay nasa US dollars bilang mga string na may dalawang decimal. Ang mga oras ay ISO 8601 sa UTC.

Endpoints

GET/balanceAng iyong credit sa US dollars.

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

GET/prices?country=usMga bansa, panahon at presyo. Iwanan ang bansa para sa lahat.

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

POST/rentalsMag-renta ng isang numero. Body: bansa at araw.

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=activeAng iyong mga renta, pinakabago muna (estado: aktibo, expired, kinansela).

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

GET/rentals/{id}Isang renta kasama ang inbox nito.

{ "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}/extendMagdagdag ng panahon sa aktibong renta. Katawan: araw.

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

POST/rentals/{id}/cancelBuong refund sa loob ng 20 minuto habang walang SMS na dumating.

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

Mga Error

Ang mga error ay nagbabalik ng HTTP status at { "error": { "code", "message" } }.

Estado	Kodigo	Kahulugan
401	no_key, bad_key	Nawawala o maling API key
402	no_balance	Hindi sapat na credit
404	not_found	Hindi mahanap ang renta
409	ended, cancel_denied	Tapos na ang renta, o lumipas na ang cancel window
429	rate_limited, too_many_active	300 request kada minuto, o 20 aktibong numero
503	network_error	Subukan muli sa ilang sandali