Tổng Kho eSIM
Versionierung

Versionsverlauf

API-Versionen folgen /v1. Inkompatible Änderungen erhalten einen neuen Präfix, ohne /v1 still zu ändern. Webhooks sind separat versioniert. Aktuelle Spezifikation: v2.4.0.

Versionsverlauf

v2.4.0Neueste Version
  • HinzugefügtOpenAPI-Mitglieder können tke_member_test_-Schlüssel auf api-testing.tongkhoesim.com erstellen: virtuelles Guthaben, simulierte Bestellungen/eSIMs, Beispieldaten und Szenarien. Live/Test-Schlüssel sind getrennt; Testdaten verändern weder echtes Guthaben, Verlauf, Rang noch Rechnungen.
  • HinweisSammelbestellungen und Webhooks für Mitglieder bleiben nicht unterstützt. Erstattungsprüfungen sind nur live, Teststornierungen erstatten virtuelles Guthaben. Seed/Reset benötigen Idempotency-Key, Reset benötigt reason. Test ruft keine echten Anbieter auf und stellt keine echten MISA-Rechnungen aus.
v2.3.0Stabil
  • HinzugefügtAusgewählte Mitglieder können nach Admin-Freigabe Live-Schlüssel für die Open API erhalten. Bestellungen, Wallets, Erstattungen und Rechnungen bleiben dem Mitglied zugeordnet. Vereinbarte Sonderpreise sind Endpreise ohne zusätzlichen Rangrabatt.
  • HinweisNeu sind GET/POST /v1/esims/{id}/refund-requests für Mitglieder und optionales invoice_buyer bei Mitgliedsbestellungen. Ohne Käuferangabe bleibt der Verbraucher-Rechnungsablauf erhalten. Stapel, Webhooks und Testmodus bleiben Organisationen vorbehalten; Mitglieder erhalten capability.not_supported.
v2.2.0Stabil
  • HinzugefügteSIM-Webhooks (esim.delivered, esim.activated, esim.usage_threshold, esim.expiring) enthalten order_id und external_ref zur Zuordnung ohne weiteren API-Aufruf.
  • HinzugefügtGET /v1/esims, GET /v1/esims/{id} und items[] enthalten external_ref. ?external_ref=… findet eSIMs einer Bestellung; ?iccid=… liefert weiter die id.
  • HinzugefügtSimulation von status enabled mit POST /v1/testmode/esims/{id}/simulate sendet esim.activated genau einmal wie im Live-Modus.
  • HinweisPreise in /v1/catalog/packages entsprechen genau der Organisationsbelastung einschließlich Vertragspreisen.
  • HinweisKompatibel: nur Felder ergänzt. external_ref ist immer vorhanden und ohne Bestellreferenz null.
v2.1.0Stabil
  • HinzugefügtDer Anbieterumfang begrenzt Katalog, Details, Bestellungen und plan-options. Außerhalb: partner.package_not_visible / order.package_not_allowed. Warnung filtered_by_provider_scope; catalog.updated enthält nur erlaubte SKUs. Anbieter werden nie offengelegt.
  • HinweisKompatibel: keine Änderung für Organisationen ohne Einschränkung.
v2.0.0Stabil
  • HinzugefügtEinheitliches /v1: {items, next_cursor, page_size, total, mode, warnings[]}, id je Entität, Beträge {amount, currency}, usage{}, Installation per ?include=lpa, cancellable{allowed,reason,disclosed_at}. topup-options/topup wird plan-options/change-plan.
  • HinzugefügtTestmodus: api-testing.tongkhoesim.com mit tke_test_, Live mit tke_live_. Falscher Host: 403 partner.wrong_host. Neue /v1/testmode/*: status, seed, reset, esims/{id}/simulate, webhooks/fire, webhooks/fail-next. Automatische Beispieldaten beim ersten Schlüssel und periodischer Verbrauch.
  • HinweisVor dieser Version waren keine Partner integriert; ab hier stabilisiert sich der Vertrag.