API
Panel ile aynı fiyattan işlem yaparsınız. Anahtarı bağlantının içine değil, istek başlığına ekleyin. Bakiye sorgusu her zaman günceldir.
Panel ile aynı
Alımlar önce bakiyeden düşer; başarısız olursa iade. İlk SMS’ten sonra requestNextSms veya rent/:id/next ile bir SMS daha istenebilir. Satın alma ~20 dk; kiralama süre bitene kadar. Profil · Nasıl kullanılır.
GET /api/v1/account/getNumber?serviceId=x-api-key: ••••••GET /api/v1/account/getMessage/<id>→ { "code": "847291" }
Account
Prefer Authorization: Bearer or x-api-key — keys stay out of access logs. PHP path URLs still work for scripts (not browsers).
/api/v1/account/getBalanceLive spendable balance (PHP shape)
/api/v1/account/getServicesCatalog by category
/api/v1/account/getServiceDetails/:idPrice + stock
/api/v1/account/countryMappingsCountry name → ISO
/api/v1/account/getActivationsHistory + TTL sync (may refund expired PENDING)
/api/v1/account/getNumber?serviceId=Buy
/api/v1/account/getNumber/:serviceIdBuy via path
/api/v1/account/getMessage/:idPoll SMS
/api/v1/account/requestNextSms/:idNext SMS on the same number
/api/v1/account/cancelNumber/:idCancel + refund if eligible
/api/v1/account/rentList (soft-expire) / buy rent
/api/v1/account/getRentActivationsRent list PHP alias
/api/v1/account/getRentNumber/:country/:service/:timeRent buy PHP alias
/api/v1/account/getRentMessage/:idRent poll PHP alias
/api/v1/account/cancelRentNumber/:idRent cancel PHP alias
/api/v1/account/rent/:id/messagePoll rent SMS
/api/v1/account/rent/:id/nextRequest another SMS on the same rental
/api/v1/account/rent/:id/cancelCancel rent
Legacy path key
PHP-style `/api/v1/<apiKey>/…` for curl/bots. Disabled in production unless ALLOW_PATH_API_KEYS=true. Browser Origin is always ignored — use Bearer / x-api-key.
/api/v1/<apiKey>/getBalanceLive spendable balance (PHP shape)
/api/v1/<apiKey>/getServicesCatalog by category
/api/v1/<apiKey>/getServiceDetails/:idPrice + stock + country flag
/api/v1/<apiKey>/countryMappingsCountry name → ISO
/api/v1/<apiKey>/getNumber?serviceId=Buy (also GET …/getNumber/:serviceId)
/api/v1/<apiKey>/getMessage/:idPoll SMS — PHP-shaped status 0|1|-1
/api/v1/<apiKey>/requestNextSms/:idRequest another SMS on the same number
/api/v1/<apiKey>/cancelNumber/:idCancel + refund if eligible
/api/v1/<apiKey>/getActivationsHistory + TTL sync (may refund expired PENDING)
/api/v1/<apiKey>/rentList / buy rent
/api/v1/<apiKey>/getRentActivationsRent list (PHP path)
/api/v1/<apiKey>/getRentNumber/:country/:service/:timeRent buy (PHP path)
/api/v1/<apiKey>/getRentMessage/:idRent poll (PHP path)
/api/v1/<apiKey>/cancelRentNumber/:idRent cancel (PHP path)
/api/v1/<apiKey>/rent/:id/messagePoll rent SMS
/api/v1/<apiKey>/rent/:id/nextRequest another SMS on the same rental
/api/v1/<apiKey>/rent/:id/cancelCancel rent (2–20 min, no SMS)
Public catalog
No auth — categories, services, rent catalog, social proof.
/api/v1/getCategoriesPublic categories
/api/v1/getAllServicesPublic services
/api/v1/getRandomOrderSocial proof
/api/v1/getActivisionsRecent success feed
/api/v1/getServerTimestampUnix timestamp (plain text)
/api/v1/getRentCountriesRent countries + flags
/api/v1/getRentServicesListRent services catalog
/api/v1/getRentServices/:countryIdRent prices (?time=hours)
Responses
// buy (activation or rent — rent title "Rental purchased")
{ "success": true, "number_id": "<id>", "number": "+…", "id": "<id>" }
{ "success": false, "message": "…", "error": "NO_NUMBERS|INSUFFICIENT_BALANCE|…" }
// getMessage (activation + rent poll — rent also keeps message / rent_status)
{ "id": "<id>", "code": "123456"|null, "status": 0|1|-1, "sms_entries": [...], "finished": false }
// cancel (rent: "Rental canceled")
{ "success": true, "message": "Number canceled and balance refunded.", "refunded": true }Errors
Auth failures return { "error": "<CODE>" }. Buy and cancel return success: false with message and error.
| HTTP | Code | When |
|---|---|---|
| 401 | INVALID_KEY | Missing / unknown API key |
| 403 | BANNED | Account banned (key may still resolve) |
| 429 | RATE_LIMITED | Per-user or public IP throttle |
| 400 | INSUFFICIENT_BALANCE | Buy / rent debit refused |
| 400 | NO_NUMBERS | No stock for that operator |
| 400 | TOO_EARLY_CANCEL / TOO_EARLY | Cancel before min window (rent: TOO_EARLY) |
| 400 | HAS_SMS | Cancel blocked — SMS already delivered |
| 400 | INVALID_STATE | Wrong status for poll / next / cancel |
| 400 | PROVIDER_ERROR | Upstream failure (generic copy) |
| 400 | BUY_UNCERTAIN | Debit held — do not retry until settle |
Numara almaya hazır mısınız?
Hesap oluştur. Anahtar, girişten sonra Profil’de.