RESTful API V1.0

Geliştirici & API Portalı

Mevcut rezervasyon, ERP, mobil uygulama veya web sistemlerinize anında küresel eSIM üretim yeteneği kazandırın.

API Key Talep Et
Güvenli Kimlik Doğrulama
Bearer Token & X-API-KEY
Standart Çıktı Biçimi
Yalnızca JSON Giriş / Çıkış
Yüksek Performans
< 250ms eSIM Sipariş Süresi
POST /api/v1/esim/order

eSIM Siparişi Oluştur

Bu uç nokta, kurumsal bakiyenizi kullanarak belirlediğiniz paket ID'sine göre anında yeni bir eSIM profili sipariş etmenizi ve müşteriye sunulacak QR kod verilerini üretmenizi sağlar.

İstek Başlıkları (Headers)
Parametre Tip Açıklama
X-API-KEY String Portal üzerinden size atanan kurumsal gizli anahtar.
Content-Type String application/json değerini almalıdır.
Gövde Parametreleri (Body)
Alan Tip Zorunlu mu? Açıklama
packageId String Evet Satın alınacak veri paketinin benzersiz kodu (örn: EU-1GB-7D).
referenceId String Hayır Sizin sisteminizdeki benzersiz sipariş veya rezervasyon numarası.
İstek ve Yanıt Örneği (JSON) JSON

// HTTP POST Request Body

{
                        "packageId": "TUR-5GB-30D",
                        "referenceId": "INV-2026-0089"
}

// HTTP 201 Created Response

{
  "success": true,
  "message": "eSIM profile created successfully.",
  "data": {
    "orderId": "ESIM-998231-TR",
    "iccid": "89033000000000001234",
    "package": "Turkey 5GB 30 Days",
    "qrCodeUrl": "https://api.travelesim.com/qr/8903300000.png",
    "lpaString": "LPA:1$rsp.travelesim.com$ORDER-KEY-123",
    "status": "Active"
  }
}
GET /api/v1/partner/balance

Kurumsal Bakiye Sorgula

B2B acente hesabınızda anlık olarak kalan finansal limitinizi ve aktif eSIM operasyonları için harcanabilir bakiye durumunu sorgulamak amacıyla kullanılır.

Bu metot herhangi bir istek gövdesi (Body) gerektirmez, sadece başlıkta X-API-KEY göndermeniz yeterlidir.

HTTP 200 OK Response JSON 
{
  "success": true,
  "data": {
    "partnerName": "TRAVEL E-SIM LLC",
    "currency": "USD",
    "currentBalance": 1450.75,
    "tierLevel": "Tier 2 - Silver",
    "activeEsimCount": 342
  }
}

Hemen Entegrasyona Başlayın

Yazılımcı ekibiniz için hazırladığımız kapsamlı Postman koleksiyonunu indirmek ve test ortamı (Sandbox) kimlik bilgilerine erişmek için hemen kurumsal hesabınızı aktifleştirin.

Sandbox Erişimi Al Teknik Destek