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ş, paket yükleme, 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ış fırsatı sunun. Yolcularınız bağlı olarak iner ve satılan her plandan marj sizde kalır.

Bayiler ve MVNO'lar

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

IoT ve Filo Platformları

Tek bir entegrasyonla sınır ötesi cihazlar ve araçlar için 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 fiyatlarla mevcut her veri paketine göz atın ve sipariş vermeden önce hesap bakiyenizi kontrol edin.

Tüm Paketleri AlBakiye Sorgulama

Siparişler ve Paket Yüklemeleri

Yeni eSIM'leri anında sağlayın ve mevcut olanlara 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şturPaket Yükleme ve Siparişler

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 bayi 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 bulunur.

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. Bir işletme hesabı oluşturun

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

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ı, Yanıtlandı

eSIMfly eSIM API nedir?+

eSIMfly API, toptan fiyatlarla programatik olarak eSIM satın almanızı, sağlamanızı ve yönetmenizi sağlayan bir REST API'dir. Paket kataloğuna göz atabilir, sipariş oluşturabilir, planlara 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; 450'den fazla ağ üzerinden 200 ülke 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 hizmet.

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

İstekler, HMAC-SHA256 imzalarıyla doğrulanır. Her istek, gizli anahtarınızla hesaplanan bir erişim kodu, benzersiz bir istek kimliği, bir zaman damgası ve 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 edinirim?+

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 Japan 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ğlar 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 sağlar. 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 ajanı mı kullanıyorsunuz? Barındırılan MCP sunucusunu https://mcp.esimfly.net/mcp Claude, ChatGPT veya Cursor'a ekleyin ve işletme hesabınızla oturum açın — yapıştırılacak anahtar yok. Planları arayın, kullanımı kontrol edin ve canlı API'ye karşı eSIM'leri teşhis edin; varsayılan olarak salt okunur, herhangi bir siparişten önce bir onay adımıyla. Yerel mi tercih edersiniz? npx -y @esimfly/mcp.

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Ü

Paket Yüklemeleri, Kullanım Takibi ve Webhook'lar

Canlı kullanım sorguları, mevcut eSIM'lerde paket yükleme 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.