İki izin varsayılan olarak kapalıdır. Müşteri panelinden ayrı ayrı açılır ve aynı anahtar kullanılır. Tutarlar USD sentidir.
Kiralık numara
GET/api/v1/products
GET/api/v1/rental/catalog
GET/api/v1/rental/options?country=TR
POST/api/v1/rental/quotes
{"country":"TR","term":"30d"}
eSIM
GET/api/v1/esim/catalog
GET/api/v1/esim/options?location=TR
POST/api/v1/esim/quotes
{"packageCode":"PACKAGE_CODE","quantity":1}
Kiralık numarada ülke ve süreyi seçeneklerden al. Servise özel kiralama için service ekle. Günlük eSIM paketlerinde days gönder. Her iki üründe de teklifi aşağıdaki satın alma isteğine geçir.
Sipariş ve takip
POST/api/v1/{rental|esim}/orders
Idempotency-Key: order-0002
{"quote_id":"QUOTE_UUID","max_price_minor":550}
GET/api/v1/{rental|esim}/orders
GET/api/v1/{rental|esim}/orders/{id}
POST/api/v1/{rental|esim}/orders/{id}/refresh
POST/api/v1/rental/orders/{id}/cancel
Sipariş ayrıntıları kiralık numaranın SMS kutusunu veya eSIM kurulum profilini içerir. Kiralık iptalinde can_cancel alanını kontrol et.
Bakiye
GET/api/v1/balance
Kullanılabilir bakiye. 5000 sent = 50,00 USD. Bakiye aşağı, teklif fiyatı yukarı yuvarlanır.
quote_id ve max_price_minor zorunludur. Idempotency-Key başlığında siparişe özel 8–100 karakter gönder. Ağ hatasında aynı anahtar ve aynı gövde ile tekrar dene.
Kendi siparişini kimliğiyle sorgula. sms_code boşsa kod henüz teslim edilmemiştir. API siparişlerinde teklifin USD fiyatı korunur. USD kaydı olmayan siparişlerde price null döner. Zaman damgaları UTC ISO 8601 biçimindedir.
purchasing / waitingİşleniyor veya SMS bekleniyor.
received / completedKod geldi veya işlem tamamlandı.
reviewSonuç kontrol ediliyor. Yeni sipariş oluşturmadan mevcut siparişi sorgula.
refundedÜcret iade edildi.
Her sipariş için yeni bir Idempotency-Key gönder. Aynı isteği tekrar denerken aynı anahtarı kullan. Kod gelmediyse iptal en erken 180 saniye sonra açılır. Sağlayıcı daha geç bir süre bildirebilir. Webhook henüz yok.
04
Hatalar ve limitler
Limit hesap başına dakikada 60 istektir. Satın alma 201 ile yeni sipariş, 200 ile mevcut/sonuçlanmış sipariş veya 202 ile kontrol edilen sipariş döndürebilir.