Historique des versions
Les versions API suivent /v1. Les ruptures utilisent un nouveau préfixe sans changer /v1 silencieusement. Webhooks versionnés séparément. Spécification actuelle : v2.4.0.
Historique des versions
v2.4.0Dernière version
- AjoutLes membres autorisés à OpenAPI peuvent créer des clés tke_member_test_ sur api-testing.tongkhoesim.com, utiliser des fonds virtuels, commandes/eSIM simulées, exemples et scénarios. Les modes Réel/Test sont séparés ; le test n’affecte ni portefeuille, historique, rang ou factures réels.
- NoteLes commandes groupées et webhooks membre restent non disponibles. Les demandes de remboursement sont réservées au réel ; l’annulation de test rembourse le virtuel. Seed/reset membre exigent Idempotency-Key et reset exige reason. Aucun appel fournisseur ou facture MISA réelle en test.
v2.3.0Stable
- AjoutCertains membres peuvent recevoir des clés Open API réelles après accord administrateur. Commandes, portefeuilles, remboursements et factures restent au membre. Les prix négociés sont définitifs, sans réduction de rang supplémentaire.
- NoteAjout de GET/POST /v1/esims/{id}/refund-requests pour les membres et de invoice_buyer facultatif sur leurs commandes. Sans acheteur déclaré, le parcours de facture consommateur est conservé. Lots, webhooks et mode test restent réservés aux organisations ; les membres reçoivent capability.not_supported.
v2.2.0Stable
- AjoutLes webhooks eSIM (esim.delivered, esim.activated, esim.usage_threshold, esim.expiring) incluent order_id et external_ref pour retrouver votre commande sans autre appel API.
- AjoutGET /v1/esims, GET /v1/esims/{id} et items[] incluent external_ref. Filtrez par ?external_ref=… pour les eSIM d’une commande ; ?iccid=… reste disponible pour retrouver l’id.
- AjoutSimuler status enabled sur POST /v1/testmode/esims/{id}/simulate émet esim.activated une seule fois, comme en réel.
- NoteLes prix /v1/catalog/packages correspondent exactement au débit de votre organisation, contrat inclus.
- NoteCompatible : champs ajoutés uniquement. external_ref existe toujours et vaut null sans référence à la commande.
v2.1.0Stable
- AjoutLe périmètre fournisseur de l’organisation limite catalogue, détail, commandes et plan-options. Hors périmètre : partner.package_not_visible / order.package_not_allowed. Avertissement filtered_by_provider_scope ; catalog.updated ne contient que les SKU autorisés. Aucun champ ne révèle le fournisseur.
- NoteCompatible : aucun changement pour les organisations sans restriction.
v2.0.0Stable
- AjoutRéponses /v1 unifiées : {items, next_cursor, page_size, total, mode, warnings[]}, id sur chaque entité, montants {amount, currency}, usage{} unique, installation via ?include=lpa, cancellable{allowed,reason,disclosed_at}. topup-options/topup devient plan-options/change-plan.
- AjoutMode test : api-testing.tongkhoesim.com avec tke_test_, réel avec tke_live_. Mauvais hôte : 403 partner.wrong_host. Nouveaux /v1/testmode/* : status, seed, reset, esims/{id}/simulate, webhooks/fire, webhooks/fail-next. Exemples automatiques à la première clé et consommation périodique.
- NoteAucun partenaire intégré avant cette version ; le contrat commence à se stabiliser ici.