eSIMfly MCP

Geliştiriciler için eSIM API: Kendi Ürününüzde eSIM Satın

Tek bir REST API üzerinden 200 ülke için toptan eSIM veri planlarını uygulamanıza, platformunuza veya mağazanıza entegre edin — katalog, sipariş, ek paket, kullanım ve tam yaşam döngüsü yönetimi.

eSIM API Üzerine Kimler Geliştirme Yapar

Şirketler, mevcut ürünlerine bağlantı geliri eklemek için toptan eSIM entegrasyonunu kullanır.

Seyahat Uygulamaları ve OTA'lar

Rezervasyon anında eSIM satışı sunun. Yolcularınız bağlantılı şekilde iner ve sattığınız her plandan marj elde edersiniz.

Bayiler ve MVNO'lar

eSIM'leri toptan fiyatlarla tedarik edin ve kendi fiyatlandırmanız ve paketlemenizle kendi kanallarınızdan satın.

IoT ve Filo Platformları

Tek bir entegrasyonla cihazlar ve araçlar için sınır ötesi bağlantı sağlayın ve izleyin.

Süper Uygulamalar ve Fintech

Ödemeler, bankacılık veya sadakat ürünlerinin yanına uluslararası veri planlarını yerel bir özellik olarak ekleyin.

API YETENEKLERİ

eSIM'leri Programatik Olarak Çalıştırmak İçin İhtiyacınız Olan Her Şey

API, toptan paketlere göz atmaktan sahadaki canlı eSIM'leri yönetmeye kadar tüm yolculuğu kapsar.

Katalog ve Fiyatlandırma

200 ülke için toptan fiyatlandırmayla mevcut tüm veri paketlerine göz atın ve sipariş vermeden önce hesap bakiyenizi kontrol edin.

Tüm Paketleri AlBakiye Sorgulama

Siparişler ve Ek Paketler

Yeni eSIM'leri anında sağlayın ve mevcut olanlara ek paket yükleyin. Siparişler, kullanıcılarınıza teslim etmeye hazır QR kodları ve aktivasyon ayrıntılarını döndürür.

Sipariş OluşturPaketleri ve Siparişleri Güncelle

eSIM Yaşam Döngüsü

Verdiğiniz her eSIM'i yönetin: durumu ve veri kullanımını kontrol edin, hatları askıya alın veya iptal edin, ağ olaylarını inceleyin ve SMS gönderin.

eSIM'leri Listele / SorgulaeSIM Durumuİptal / Askıya Al / EtkinleştirKullanım RaporuAğ OlaylarıSMS Gönder

Webhook'lar

Sipariş ve eSIM yaşam döngüsü olayları için gerçek zamanlı bildirimler almak üzere uç noktalar kaydedin — yoklama gerekmez.

Webhook YönetimiOlay Bildirimleri

Toptan eSIM Oranları, Sizin Marjınız

API ortakları, veri paketlerini toptan fiyatlarla satın alır ve kendi perakende fiyatlarını belirler. Katalog, 200 ülke ve 450'den fazla ağ genelinde yerel, bölgesel ve küresel planları kapsar; böylece tek bir entegrasyon, kullanıcılarınızın seyahat ettiği her destinasyonu kapsar. Bakiye tabanlı faturalandırma, mutabakatı basit tutar: hesabınıza para yükleyin ve her sipariş, toptan oranınız üzerinden bu bakiyeden çekilir.

Kendi mağazanızı oluşturmak yerine eksiksiz bir mağaza vitrini istiyorsanız, beyaz etiketli eSIM platformumuz, aynı altyapı üzerinde markalı bir web sitesi, kontrol paneli ve mobil uygulamalar sunar.

Tasarım Gereği Güvenli: HMAC İmzalı İstekler

Her API çağrısı, istek zaman damgası, benzersiz bir istek kimliği, erişim kodunuz ve istek gövdesi üzerinde HMAC-SHA256 imzasıyla doğrulanır — bütünlük doğrulaması ve tekrar saldırısı koruması sağlar. Node.js, Python ve PHP için hazır imzalama örnekleri dokümantasyonda mevcuttur.

POST /api/v1/business/orders HTTP/1.1
Host: esimfly.net
Content-Type: application/json
RT-AccessCode: your-access-code
RT-RequestID: 6f1c2e4a-...        # unique UUID v4
RT-Timestamp: 1752403200000       # ms since epoch
RT-Signature: A3F0...             # HMAC-SHA256, see docs

{ "package_code": "...", "quantity": 1 }

Üç Adımda API Erişimi Edinin

1. İşletme hesabı oluşturun

Bir eSIMfly işletme hesabına kaydolun ve kullanım senaryonuz ile beklenen hacminizi bize anlatın.

2. API anahtarlarınızı oluşturun

İşletme kontrol panelinden erişim kimlik bilgileri oluşturun ve yönetin, ardından bakiyenizi yükleyin.

3. Entegre edin ve başlatın

Paketlere göz atmak, test siparişi vermek ve isteğe bağlı olarak asenkron sağlanan eSIM'ler için bir webhook kaydetmek üzere dokümantasyonu izleyin.

SSS

eSIM API Soruları, Cevapları

eSIMfly eSIM API nedir?+

eSIMfly API, eSIM'leri toptan fiyatlarla programatik olarak satın almanızı, sağlamanızı ve yönetmenizi sağlayan bir REST API'dir. Paket kataloğuna göz atabilir, siparişler oluşturabilir, planlara ek paket yükleyebilir, kullanımı izleyebilir ve kendi uygulamanızdan tam eSIM yaşam döngüsünü (etkinleştirme, askıya alma, iptal) yönetebilirsiniz; 200 ülke ve 450'den fazla ağ kapsamıyla.

eSIM API kimler içindir?+

API, eSIM bağlantısını kendi ürününe gömmek isteyen şirketler için oluşturulmuştur: seyahat uygulamaları ve rezervasyon platformları, telekom bayileri ve MVNO'lar, IoT ve filo platformları ve operatör ilişkileri kurmadan kullanıcılarına uluslararası veri sunmak isteyen her türlü hizmet.

API kimlik doğrulaması nasıl çalışır?+

İstekler, HMAC-SHA256 imzalarıyla doğrulanır. Her istek, bir erişim kodu, benzersiz bir istek kimliği, bir zaman damgası ve gizli anahtarınızla hesaplanan bir imza taşır; bu, istek bütünlüğü doğrulaması sağlar ve tekrar saldırılarını önler. Node.js, Python ve PHP için kod örnekleri dokümantasyonda mevcuttur.

eSIM API erişimini nasıl alırım?+

Bir eSIMfly işletme hesabı oluşturun, ardından işletme kontrol panelinden API anahtarları oluşturun. Toptan fiyatlandırma katmanları hacme bağlıdır — beklenen sipariş hacminiz için oranları görüşmek üzere satış ekibimizle iletişime geçin.

API webhook'ları destekliyor mu?+

Evet. Webhook'lar, asenkron sağlanan eSIM'ler hazır olduğunda sizi bilgilendirir — bazı operatörler (KDDI Japonya gibi) birkaç dakika sürer ve yoklama yapmak yerine eSIM ayrıntılarıyla imzalı bir POST alırsınız. Çoğu sağlayıcı, sipariş yanıtında senkron olarak sağlama yapar ve durum ile kullanım, durum ve kullanım uç noktaları üzerinden sorgulanır.

API hız sınırları nelerdir?+

API, hesap başına saatte 1.000 istek izin verir. 5 dakikadan eski istekler, tekrar saldırısı korumasının bir parçası olarak reddedilir. Entegrasyonunuz için daha yüksek limitlere ihtiyacınız varsa satışla iletişime geçin.

RESMİ SDK · NODE.JS / TYPESCRIPT

İmzalama kodunu atlayın — SDK'yı kurun

npm install @esimfly/sdk size tüm API'ye yazılmış erişim sağlar — HMAC imzalama, taze istek kimlikleri, idempotent siparişler, tempolu katalog senkronizasyonu ve webhook imza doğrulaması dahildir. Sıfır bağımlılık, Node.js 18+, MIT lisanslı ve açık kaynak. PHP ve Python SDK'ları sırada.

Bir AI aracısı mı kullanıyorsunuz? Resmi MCP sunucusu (npx -y @esimfly/mcp), Claude, Cursor veya ChatGPT'nin planları aramasına, kullanımı kontrol etmesine ve canlı API'ye karşı eSIM'leri teşhis etmesine olanak tanır — varsayılan olarak salt okunur ve herhangi bir siparişten önce bir onay adımı içerir.

Entegrasyon Eğitimleri

İlk istekten üretim webhook'larına kadar çalışan Node.js kodu.

[

BURADAN BAŞLAYIN · MİMARİ REHBERİ

eSIM API Entegrasyon Rehberi

Dört yapı taşı, imzalı kimlik doğrulama, senkron vs webhook sağlama, bir sağlayıcı değerlendirme kontrol listesi ve yalnızca üretimde ortaya çıkan tuzaklar.

Rehberi okuyun](https://esimfly.net/esim-api/integration-guide)

[

BÖLÜM 1 · ~30 DAKİKA

Node.js ile Uygulamanızda eSIM Satın

HMAC kimlik doğrulama, paket kataloğu, sipariş oluşturma ve QR kod teslimi — eksiksiz çalışan bir mağaza vitrini.

Eğitime başlayın](https://esimfly.net/esim-api/tutorials/sell-esims-nodejs)[

BÖLÜM 2 · YAŞAM DÖNGÜSÜ

Ek Paketler, Kullanım Takibi ve Webhook'lar

Canlı kullanım sorguları, mevcut eSIM'lerde ek paket satışları ve yoklama olmadan imzalı webhook'lar.

İkinci bölüme devam edin](https://esimfly.net/esim-api/tutorials/topups-usage-webhooks)

eSIM'leri ürününüze entegre etmeye hazır mısınız?

Dokümantasyonla başlayın veya hacminiz için toptan oranlar hakkında ekibimizle konuşun.