GMT Partner API

GET/me

Проверяет ключ и возвращает общий баланс GMT.

{
  "success": true,
  "data": {"telegram_id": 123456789, "balance_rub": 2500.0, "currency": "RUB"}
}

GET/recommendations

Возвращает короткое обязательное условие о видеозаписи. Покажите его клиенту один раз непосредственно перед покупкой.

{
  "success": true,
  "data": {"version": "2026-09-07", "text": "🔴 Важно перед покупкой..."}
}

После согласия передайте в заказе "recommendations_accepted": true.

GET/products

Актуальный каталог с ценами и остатками.

{
  "success": true,
  "data": [{
    "id": 123,
    "name": "Россия | Telegram 14+ дней",
    "description": "Описание товара",
    "country_code": "RU",
    "country": "🇷🇺 Россия",
    "stock": 304,
    "price_rub": 227.17,
    "formats": ["tdata", "sessionjson", "phonecode"]
  }]
}

GET/products/{product_id}

Один товар. Скрытый или отсутствующий товар возвращает PRODUCT_NOT_FOUND.

POST/orders

Создаёт и оплачивает заказ с общего баланса.

Заголовки

Authorization: Bearer ВАШ_API_КЛЮЧ
Content-Type: application/json
Idempotency-Key: order-2026-000042

curl -X POST https://getmytelegram-api.duckdns.org/api/v1/orders \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-2026-000042" \
  -d '{
    "product_id": 123,
    "format": "tdata",
    "quantity": 1,
    "external_order_id": "my-order-42",
    "recommendations_accepted": true
  }'

Ответ HTTP 202

{
  "success": true,
  "data": {
    "id": 8421,
    "external_order_id": "my-order-42",
    "status": "processing",
    "product": {"id": 123, "name": "Россия | Telegram 14+ дней"},
    "format": "tdata",
    "quantity": 1,
    "amount_rub": 227.17,
    "created_at": "2026-09-04 02:10:00",
    "completed_at": null
  }
}

GET/orders/{order_id}

Состояние заказа текущего партнёра.

Готовый архив

{
  "success": true,
  "data": {
    "id": 8421, "status": "completed", "format": "tdata",
    "quantity": 1, "amount_rub": 227.17,
    "download_url": "/api/v1/orders/8421/download"
  }
}

Готовый «Номер + код»

{
  "success": true,
  "data": {
    "id": 8422, "status": "completed", "format": "phonecode",
    "delivery": {"phone": "+79990000000", "code": "12345", "twofa_password": null}
  }
}

GET/orders?limit=20&offset=0

Список от новых к старым. limit 1–100, offset от 0.

GET/orders/{order_id}/download

Скачивает ZIP готового заказа. Авторизация обязательна.

curl -L https://getmytelegram-api.duckdns.org/api/v1/orders/8421/download \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  --output order_8421.zip

Пока заказ не готов: HTTP 409, ORDER_NOT_READY.

POST/orders/{order_id}/phonecode

Первый код

1. Создайте заказ с format: phonecode.
2. Опрашивайте заказ, пока в delivery.phone не появится номер.
3. Покажите номер клиенту. Он должен ввести его в Telegram и запросить код.
4. Продолжайте GET: при completed код будет в delivery.code.

Повторный код

Метод доступен только для завершённого заказа и запускает ровно одну новую сессию кода. После ответа 202 клиент снова запрашивает код в Telegram. Пока идёт ожидание, delivery.code и delivery.twofa_password равны null, чтобы старый код нельзя было принять за новый. Тело запроса не требуется.

curl -X POST https://getmytelegram-api.duckdns.org/api/v1/orders/8422/phonecode \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ"

{
  "success": true,
  "data": {"order_id": 8422, "status": "waiting"}
}

Опрашивайте заказ: phonecode_reissue_status станет completed или failed, а успешный новый код появится в delivery.code. При ошибке покажите клиенту понятный текст из phonecode_reissue_error.

GET/transactions?limit=30&offset=0

Пополнения, списания и возвраты общего баланса.

{
  "success": true,
  "data": [{
    "id": 991, "amount": -227.17, "operation_type": "api_purchase_reserve",
    "reason": "API-заказ №8421", "order_id": 8421, "created_at": "2026-09-04 02:10:00"
  }],
  "pagination": {"limit": 30, "offset": 0}
}