Dokumentasi API Reseller

Contoh cepat

cURL

curl -s https://gtckuy.my.id/api/v1/lookup \
  -H 'X-API-Key: rk_live_GANTI_KEY' -H 'Content-Type: application/json' \
  -d '{"phones":["081336111860"]}'

Python

import requests
r = requests.post('https://gtckuy.my.id/api/v1/lookup',
  headers={'Authorization': 'Bearer rk_live_GANTI_KEY'},
  json={'phones': ['081336111860']}, timeout=30)
print(r.json()['results'][0])

JavaScript

const r = await fetch('https://gtckuy.my.id/api/v1/lookup', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-API-Key': 'rk_live_GANTI_KEY' },
  body: JSON.stringify({ phones: ['081336111860'] }),
});
console.log((await r.json()).results[0]);

Checklist AI agent

• Base URL: https://gtckuy.my.id/api/v1 (lokal: http://localhost:3000/api/v1).
• Dua header auth didukung; prioritas Authorization: Bearer.
• phones maks 5; 200 walau sebagian failed per-nomor.
• Harga = GET /v1/balance → pricePerSearch; saldo kurang → 402.
• Nomor yang tidak ada datanya (privasi/belum terdaftar) → item failed dengan errorCode: NOT_FOUND; saldo untuk nomor itu tidak dipotong (refund otomatis, lihat field refunded).
• Polling hanya untuk topup (GET /v1/topup/status?invoice_id=).
• Rate limit 60/min per-key; baca header X-RateLimit-*.

Daftar endpoint (11)

• /api/v1/auth/join
• /api/v1/auth/login
• /api/v1/auth/recovery
• /api/v1/keys
• /api/v1/keys/{id}
• /api/v1/lookup
• /api/v1/balance
• /api/v1/transactions
• /api/v1/topup
• /api/v1/topup/status
• /api/v1/openapi.json

Skema auth: apiKey, bearerAuth. Kontrak mesin lengkap di openapi.json (sumber yang sama dengan halaman ini, anti-drift).

Tabel error