Sorun Giderme

A symptom-first reference. Match the response you’re seeing, then apply the fix.

401 Yetkisiz#

{"success": false, "error": "Unauthorized"} — the proxy could not resolve your request to a user.

• Confirm the header name: X-API-Anahtarı (büyük/küçük harf duyarlı değildir) ya da Authorization: Bearer <key>. Özel adlar (API Anahtarı, X-Auth(vb.) ayrıştırılmaz.
• Eğer kullanırsanız Yetkilendirme, değer şu şekilde başlamalıdır Hamiline (boşluk bırakarak).
• Whitespace, quoting, and stray newlines in the key value all fail.
• Sebep şudur ki yenilenmiş. Old keys stop immediately — copy a fresh value from /api.
• Sorgu parametresi yedekleme ?api_key= works; URL-encode it correctly.

403 Erişime İzin Verilmiyor#

The key was recognized, but API access is not enabled for that billing account.

• Confirm plan / billing includes API access.
• On team accounts, ask an admin to confirm the org seat has API access.

404 — Unknown TikTok Shop endpoint#

Path is registered, but the handler isn’t in the public allowlist.

• Call /api/v1/tiktok-shop/.... Bare /api/tiktok-shop/... is session-only and won’t accept API keys.
• Match the path exactly (no trailing slash unless documented).

404 — Not Found#

Yönlendirici, isteği hiçbir zaman karşılayamadı.

• "Check" fiili: Birçok uç nokta yalnızca AL ya da sadece YAYIN.
• Path IDs for videos must match [A-Za-z0-9_-]+.

429 — rate limit vs credits#

Credit-exhaustion 429s include a krediler object; rate-limit 429s do not.

414 URI çok uzun#

Switch large filter sets to YAYIN JSON.

curl -X POST \
  -H "X-API-Key: $WH_API_KEY" \
  -H "Content-Type: application/json" \
  "{origin}/api/v1/tiktok-shop/products/explore" \
  -d '{"country":"US","period":"30d","category_ids":["..."],"limit":100}'

500 İç Sunucu Hatası#

{"success": false, "error": "Internal server error"} — credits for that call are refunded.

• Retry with backoff; if the same payload always 500s, contact support with a redacted request.
• Sanity-check bodies against TikTok Shop filters.

HTML instead of JSON#

• Verify {kaynak} (scheme + host).
• Prefer X-API-Anahtarı if a corporate proxy strips Yetkilendirme.

Boş veya şaşırtıcı sonuçlar#

• Don’t mix dönem ile başlangıç_tarihi / bitiş tarihi on TikTok Shop — see Zaman aralıkları.
• Set ülke explicitly (default is ABD).
• Check filter aliases in TikTok Shop filters.

Session path redirect to /giriş#

Sanity checklist#

1. curl -i -H "X-API-Key: $WH_API_KEY" {origin}/api/v1/credits → 200
2. Dashboard shows API access on the plan
3. kalan kredi (or total_remaining) > 0
4. Under ~50 requests/min
5. Path + verb match the docs

Related#