eSIMDual Reseller API

Nutzen Sie die eSIMDual-Reseller-API auf Ihrer eigenen Website oder in Ihrer App.

Diese Dokumentation behandelt Authentifizierung, Pakete, Reseller-Preise, VPN-Pläne, Bestellungen, eSIM-Ressourcen, Wallet-Daten und Webhook-Payloads der Reseller-API. Nutze die Online-Referenz oder lade die OpenAPI-JSON-Datei für Postman, Insomnia oder eigene Integrationstools herunter.

OpenAPI-JSON herunterladen Rohdaten-JSON anzeigen

Schnellstart

1Erstellen Sie ein API-Token mit POST /login
2Senden Sie Bearer-Token an alle geschützten Endpunkte
3Verwenden Sie den Idempotenzschlüssel bei der Auftragserstellung
4VPN-Pläne mit GET /vpn/plans abrufen, wenn du Secure-VPN-Optionen verkaufst
5Reseller-VPN-Abonnements mit POST /vpn/subscriptions/{id}/cancel kündigen, wenn dein Kunde den Dienst beendet
6SaaS-Release-Updates mit GET /updates/latest prüfen
7Validieren Sie Webhook-Signaturen mit Ihrem gemeinsamen Geheimnis.

Basis-URL https://esimdual.com/api/reseller/v1

Authentifizierung Authorization: Bearer <token>

Idempotenz Idempotency-Key: unique-order-key

Beispiel einer Anmeldeanfrage

curl --request POST 'https://esimdual.com/api/reseller/v1/login' \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "partner@example.com",
    "password": "StrongPassword123!",
    "device_name": "production-server"
  }'

Musterbestellungsanfrage

curl --request POST 'https://esimdual.com/api/reseller/v1/orders' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Idempotency-Key: ORDER-2026-0001' \
  --header 'Content-Type: application/json' \
  --data '{
    "package_id": 1120,
    "external_order_id": "NOANET-2026-0001",
    "device_imei": "356938035643809"
  }'

Beispielanfrage für VPN-Pläne

curl --request GET 'https://esimdual.com/api/reseller/v1/vpn/plans' \
  --header 'Authorization: Bearer YOUR_TOKEN'

Das Feld price_for_reseller ist der Betrag, den eSIMDual dem Reseller berechnet. Dein Store kann darauf einen eigenen Kundenverkaufspreis aufschlagen.

Beispielanfrage für eine VPN-Bestellung

curl --request POST 'https://esimdual.com/api/reseller/v1/vpn/orders' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Idempotency-Key: VPN-2026-0001' \
  --header 'Content-Type: application/json' \
  --data '{
    "vpn_plan_id": 1,
    "external_subscription_id": "VPN-CUSTOMER-0001",
    "customer_reference": "customer@example.com",
    "customer_price": 4.99
  }'

Beispiel für eine SaaS-Updateprüfung

curl --request GET 'https://esimdual.com/api/reseller/v1/updates/latest?current_version=1.0.0&channel=stable' \
  --header 'Authorization: Bearer YOUR_TOKEN'

Die Update-Endpunkte sind für Releases gehosteter oder selbst gehosteter SaaS-Stores. Sie werden mit demselben Reseller-Bearer-Token authentifiziert.

Webhook-Ereignisse

eSIMDual signiert Webhook-Nutzdaten mit HMAC SHA-256 unter Verwendung Ihres Webhook-Geheimnisses.

ping order.completed order.processing order.failed vpn.subscription.active vpn.subscription.cancelled vpn.subscription.expired vpn.subscription.failed

X-eSIMDual-Event

X-eSIMDual-Delivery

X-eSIMDual-Signature