Use the key in the Authorization header. Never put it in browser code or public repositories.

curl https://telegrams.shop/api/v1/catalog \
  -H "Authorization: Bearer YOUR_API_KEY"

Every purchase requires a unique Idempotency-Key.

curl -X POST https://telegrams.shop/api/v1/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-unique-001" \
  -d '{"productId":"PRODUCT_ID","quantity":1}'

Available endpoints:

• GET /api/v1/catalog
• GET /api/v1/catalog/products/{product_id}
• POST /api/v1/orders
• GET /api/v1/orders
• GET /api/v1/orders/{order_ref}
• GET /api/v1/orders/{order_ref}/download
• GET /api/v1/orders/{order_ref}/login-code
• POST /api/v1/orders/{order_ref}/login-code/refresh

Orders use the Telegram account balance linked to the key. Requests are rate-limited per key.

Full documentation: RESELLER_API.md