Документация

Публичный API использует X-API-Key. Все параметры клиентов опциональны, если не указано обязательным. Списание только за успех. Idempotency-Key предотвращает повторный минт и списание.

← Play Store · RU · EN · 中文

Authentication

X-API-Key: sk_live_...

POST /v1/tokens

Universal token endpoint. Defaults: application=telegram, platform=android. Select token_type: fcm or recaptcha. reCAPTCHA additionally requires site_key.

curl -X POST https://api.play-store.io/v1/tokens \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"application":"telegram","platform":"android","token_type":"fcm"}'

{
  "token": "...",
  "secret": "...",
  "mint_session": "...",
  "latency_ms": 123
}

GET /v1/capabilities

Returns stable identifiers and the application/platform/token_type combinations currently available.

POST /v1/push/token (compatible legacy)

FCM token. Request body may be empty.

curl -X POST https://api.play-store.io/v1/push/token \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-request-id" \
  -d '{}'

{
  "token": "...",
  "secret": "...",
  "mint_session": "...",
  "latency_ms": 123
}

POST /v1/recaptcha/mobile

Required: site_key. Optional: package, action, mint_session.

curl -X POST https://api.play-store.io/v1/recaptcha/mobile \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"site_key":"...","package":"org.telegram.messenger","action":"signup"}'

{
  "token": "...",
  "expires_at": 1800000000,
  "latency_ms": 321,
  "qa": {}
}

GET /v1/balance

{ "balance": 10.0000, "currency": "USD" }

Errors

HTTP	Code	Meaning
401	UNAUTHORIZED	Missing, revoked or blocked key
402	INSUFFICIENT_FUNDS	Rejected before minting
409	IDEMPOTENCY_CONFLICT / REQUEST_IN_PROGRESS	Same key with another payload, or request still running
503	SYSTEM_BUSY	Retry later
503	MINT_FAILED	Retry; no charge for an explicit failure

Idempotency-Key

Use a unique key for each logical request. An identical payload returns the stored response without another mint or charge. Records expire after 24 hours.