Перейти к основному содержанию
POST
/
v2
/
b2b
/
fulfilment
/
esims
/
{iccid}
/
topup
Пополнение eSIM
curl --request POST \
  --url https://api.phoenixpass.space/v2/b2b/fulfilment/esims/{iccid}/topup \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "package_template_id": 132,
  "validity_period": 30
}
'
Всегда передавайте заголовок Idempotency-Key, чтобы исключить повторное пополнение на одну операцию при повторной отправке запроса.

Заголовки

​
X-Request-ID
string

Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.

​
Idempotency-Key
string
обязательно

Уникальный ключ идемпотентности запроса (строка длиной до 256 символов), TTL 72ч.

См. раздел "Идемпотентные запросы"

Уникальный ключ идемпотентности запроса. Может быть любой строкой длиной до 256 символов. Рекомендуется использовать UUID для обеспечения глобальной уникальности.

Maximum string length: 256
Пример:

"550e8400-e29b-41d4-a716-446655440000"

Параметры пути

​
iccid
string
обязательно

ICCID выпущенной eSIM, полученный при создании ICCID — серийный номер eSIM-профиля (19–20 цифр)

Required string length: 19 - 20
Pattern: ^[0-9]+$
Пример:

"8948010000000000000"

Тело

application/json

Обратите внимание, что active_period и validity_period переопределяют стандартную механику срока действия пакета из шаблона.

При указании validity_period пакет начинает быть активным с момента его привязывание к симкарте. При указании active_period указывается окно его действия с определенной даты по определенную.

​
package_template_id
integer
обязательно

Шаблон пакета

Пример:

132

​
active_period
object

Точный период действия.

​
validity_period
integer

Срок действия пакета в днях от момента вызова.

Пример:

30

Ответ

eSIM пополнена, пакет назначен