История выпусков
Версия API задаётся префиксом пути (/v1). Несовместимые изменения получают новый префикс без скрытых изменений /v1. Версии вебхуков независимы от REST. Текущая версия спецификации OpenAPI: v2.4.0.
История выпусков
v2.4.0Последняя
- ДобавленоУчастники с OpenAPI могут создавать ключи tke_member_test_ на api-testing.tongkhoesim.com и использовать виртуальные средства, имитацию заказов/eSIM, примеры и сценарии. Рабочие/тестовые ключи разделены; тест не влияет на реальные кошельки, историю, уровень или счета.
- ПримечаниеМассовые заказы и вебхуки участника пока не поддерживаются. Рассмотрение возврата — только в рабочем режиме; тестовая отмена возвращает виртуальные средства. Для seed/reset нужен Idempotency-Key, для reset — reason. Тест не вызывает реальных провайдеров и не выпускает реальные счета MISA.
v2.3.0Стабильная
- ДобавленоВыбранные участники могут получить рабочие ключи Open API после одобрения администратором. Заказы, кошельки, возвраты и счета остаются у участника. Согласованные индивидуальные цены являются окончательными, дополнительная скидка ранга не применяется.
- ПримечаниеДобавлены GET/POST /v1/esims/{id}/refund-requests для участников и необязательный invoice_buyer в их заказах. Без данных покупателя сохраняется существующий счёт потребителя. Пакетные заказы, вебхуки и тестовый режим доступны только организациям; участники получают capability.not_supported.
v2.2.0Стабильная
- ДобавленоКаждый вебхук eSIM (esim.delivered, esim.activated, esim.usage_threshold, esim.expiring) теперь содержит order_id и external_ref — вашу ссылку на заказ. Это позволяет связать eSIM с вашим заказом без дополнительного API-запроса.
- ДобавленоБлок eSIM (GET /v1/esims, GET /v1/esims/{id}, items[] заказа) дополнен external_ref. GET /v1/esims поддерживает ?external_ref=… для получения всех eSIM заказа по вашей ссылке. Если известен только ICCID, используйте ?iccid=… для получения id.
- ДобавленоВ тестовом режиме включение eSIM через POST /v1/testmode/esims/{id}/simulate со status enabled однократно вызывает esim.activated, как в рабочем заказе. Это позволяет проверить весь сценарий установки eSIM клиентом.
- ПримечаниеЦены /v1/catalog/packages точно соответствуют списанию по заказу организации, включая договорную цену, а не базовую.
- ПримечаниеОбратная совместимость сохранена: поля только добавлены. external_ref всегда присутствует и равен null, если не был указан в заказе.
v2.1.0Стабильная
- ДобавленоОграничение каталога организации по поставщику: /v1/catalog/packages, карточка тарифа, заказы и plan-options показывают только разрешённые тарифы. Остальные считаются несуществующими (partner.package_not_visible / order.package_not_allowed). В списках появилось предупреждение filtered_by_provider_scope; catalog.updated содержит только доступные SKU. Поля не раскрывают поставщика.
- ПримечаниеОбратная совместимость: для организаций без ограничения поведение не меняется.
v2.0.0Стабильная
- ДобавленоНовый формат ответов /v1: единый список {items, next_cursor, page_size, total, mode, warnings[]}; у каждой сущности есть id; суммы передаются как {amount, currency}; расход собран в usage{}; установка (LPA/QR) возвращается только с ?include=lpa; добавлен cancellable{allowed,reason,disclosed_at}; topup-options/topup переименованы в plan-options/change-plan.
- ДобавленоТестовый режим партнёров: api-testing.tongkhoesim.com принимает только tke_test_ (рабочий хост — только tke_live_; неверный хост возвращает 403 partner.wrong_host). Добавлены /v1/testmode/*: status, seed, reset, esims/{id}/simulate, webhooks/fire, webhooks/fail-next. Первый тестовый ключ создаёт примеры; расход данных растёт автоматически с фиксированным интервалом.
- ПримечаниеДо этого выпуска у /v1 не было интегрированных партнёров; с этой версии начинается стабилизация контракта.