Sorun Giderme

Belirtilere göre hazırlanmış bir kılavuz. Sol tarafta karşılaştığınız sorunu bulun, sağ tarafta yer alan çözümü uygulayın.

401 Yetkisiz — {"success": false, "error": "Unauthorized"}#

Vekil sunucu, bir kullanıcıya yönelik isteğinizi işleyemedi.

• Başlık adını doğrulayın. Şu şekilde olmalıdır: 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ıyorsanız Yetkilendirme, değer şu şekilde başlamalıdır Hamiline (boşluk bırakarak). Authorization: <key> sadece değil eşleşme.
• Anahtar değerinde bulunan boşluklar, tırnak işaretleri ve gereksiz satır sonları, işlemin başarısız olmasına neden olur. Anahtarın hatasız olduğundan emin olmak için, isteği göndermeden hemen önce anahtarı yazdırın.
• Sebep şudur ki yenilenmiş son kopyaladığınızdan beri. Eski anahtarlar, yeniden oluşturulduğunda hemen çalışmaz hale gelir. Şuradan yeni bir değer alın: /api.
• Sorgu parametresi yedekleme ?api_key= çalışır, ancak HTTP istemcinizin bunu doğru şekilde URL kodlamasından emin olun.

403 Erişime İzin Verilmiyor — abonelik / erişim#

Anahtar tanındı, ancak bu anahtara bağlı fatura hesabı için API erişimi etkinleştirilmemiştir.

• WinningHunter'da oturum açın ve planınızı/faturalandırma bilgilerinizi kontrol edin; ayrıca kuruluşunuz için API erişiminin dahil olup olmadığını da doğrulayın.
• Erişim hakkı yeni satın alınmışsa, bir süre bekleyip tekrar deneyin; tarayıcıdaki önbelleğe alınmış oturum verileri, API anahtarı çağrılarını aynı şekilde etkilemez.
• Takım hesaplarında, yöneticinizden ilgili kullanıcının veya kuruluşun API erişimine sahip olup olmadığını doğrulamasını isteyin.

404 — Bilinmeyen TikTok Shop uç noktası#

Yol kaydedildi, ancak ilgili işleyici genel izin listesinde yer almıyor.

• Aradığınızdan emin olun /api/v1/tiktok-shop/... (the /api/v1/ ön ek önemlidir). Çıplak /api/tiktok-shop/... Bu, kontrol panelinin oturum yönlendirmesidir ve API anahtarlarını kabul etmez.
• API referansındaki yolu ve ilgili konu kılavuzunu (TikTok Shop, Meta reklam kütüphanesi, Brands, …) karşılaştırarak kontrol edin.
• Sonundaki eğik çizgiler önemlidir — belgelerde gösterilenle tam olarak aynı olmalıdır (belirtilmedikçe sonuna eğik çizgi koymayın).

404 — Bulunamadı (HTML veya genel)#

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

• "Check" fiili: Birçok uç nokta yalnızca AL ya da sadece YAYIN; bazıları her ikisini de kabul eder (GET veya POST). Doğru yolda yanlış fiil kullanıldığında 404 hatası verilir, 405 değil.
• Yol parametreleri: /api/v1/tiktok-shop/videos/{id} gerektirir {id} uygun [A-Za-z0-9_-]+. Kimlik numaraları : ya da . yönlendirilmez.

429 — İskale sınırı ve kredi tükenmesi#

İki farklı vaka aynı statüye sahiptir.

Şunu kontrol ederek program yoluyla belirsizliği giderebilirsiniz: krediler JSON gövdesindeki nesne — yalnızca kredi tükenmesi nedeniyle verilen 429 hataları bunu içerir.

414 URI çok uzun#

Bir AL çok uzun bir sorgu dizesi içeren (örneğin, düzinelerce kategori kimliği).

• Şuraya geç YAYIN JSON. POST yöntemini kabul eden TikTok Shop rotalarını keşfedin/sayın; bu rotalar, JSON gövdesindeki parametreleri sorgu dizesiyle birleştirir (bkz. TikTok Shop filtreleri).

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ı#

Vekil, yakalanmamış bir istisna yakaladı ve şu yanıtı verdi: {"success": false, "error": "Internal server error"}.

• Kredi: Bu hata aylık kredinizi tüketmez (otomatik olarak iade edilir). Yine de backoff kullanın — tekrarlanan 500 hataları genellikle hatalı girdi veya üst katmandaki bir hatayı işaret eder.
• Üstel geri çekilme yöntemiyle yeniden deneyin; aynı istek her seferinde 500 hatası veriyorsa, isteği kaydedin (anahtar gizlenmiştir) ve destek ekibiyle iletişime geçin.
• Hatalı biçimlendirilmiş JSON, hatalı ülke kodlar ya da geçersiz sayılar bazen şu şekilde ortaya çıkar: 500 derin işleyicilerden — gövdeyi şunlara göre doğrulama TikTok Shop filtreleri ya da ilgili kılavuz.

"JSON değil, HTML alıyorum"#

Uygulamaya ulaşamıyorsunuz — bir ara sunucu hata sayfası döndürüyor.

• Kökeninizi doğrulayın ({kaynak} (belgelerde). Bir yazım hatası, eksik şema ya da bölgesel bir kesinti yaşayan bir CDN, hepsi HTML sunacaktır.
• Şunu kontrol edin /api/v1/tiktok-shop/krediler (veya başka herhangi bir uç nokta), aynı makineden şu yol üzerinden çağrıldığında JSON döndürür curl -i böylece başlıkları görebilirsiniz.
• Bir kurumsal vekil yeniden yazıyorsa Yetkilendirme başlıklar, şuraya geç X-API-Anahtarı (daha az sıklıkla yanlış kullanılır).

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

• Ürünler/mağazalar çok az sayıda satır içeriyor. Muhtemelen karıştırmışsındır dönem ile başlangıç_tarihi / bitiş tarihi. Bkz. Zaman aralıkları — geç sadece dönem TikTok Shop uç noktalarında.
• ülke varsayılan olarak ABD. ABD dışındaki sorgular için bunu her zaman açıkça belirtin; aksi takdirde, filtreler doğru görünse bile ABD verileri görüntülenir.
• Takma adları filtrele. 30 günlük minimum gelir ve minimum gelir mağazalarda aynı anlama gelir; 30 günlük minimum GMV ve minimum gelir yaratıcıların/mağazaların takma adlarıdır. filtreler kılavuzu her bir varlık için standart adı ve takma adları listeler.
• tanımlanmamış diziler. Bazı istemci SDK'ları, tanımlanmamış değerleri sabit değer olarak serileştirir "tanımlanmamış" — Sunucu bunları ayıklıyor; bu nedenle, bir filtrenin eksik olması sistemi çökertmez, ancak hiçbir işlem de uygulanmaz. İstemcinizin gerçekten gönderdiği isteği kontrol edin.

"Arıyorum /api/tiktok-shop/... ve şu adrese yönlendirilmek /giriş"#

O yol şudur: oturum yol — tarayıcı çerezleri gerektirir. Bir API anahtarıyla şu komutu çağırmalısınız /api/v1/tiktok-shop/... bunun yerine.

"Ekibim anahtarımı kullanamıyor"#

Her takım üyesi şuradan bir anahtar oluşturabilir: /api oturum açmışken. Kullanım, ürün içindeki kuruluşunuzun kurallarına tabidir; eğer birisi yine de 403, şunu yapın yönetici Söz konusu lisans için planı ve API erişimini doğrulayın.

Entegrasyonunuzun doğruluğunu kontrol etme#

Bir şey mantıklı gelmediğinde bu kontrol listesini gözden geçir:

1. Yazar: curl -i -H "X-API-Key: $WH_API_KEY" {origin}/api/v1/tiktok-shop/credits getiriler 200.
2. Plan: Hesap, kontrol panelinde (plan / faturalandırma) API erişimini gösterir.
3. Kota: ve kalan kredi yukarıdan gelen > 0'dır.
4. Hız: Dakikada 50'den fazla çalıştırmıyorsunuz — dakikada 10'luk bir marj bırakın.
5. Yol: URL, API kılavuzunda veya ilgili konu kılavuzunda yer almaktadır.
6. " GET" ve "POST" fiilleri, belgelerle uyumludur.
7. Filtreler: Tarihler, zaman aralıklarına göre doğru mekanizmayı kullanır; filtre adları ise varlık başına belgelenen standart / takma ad biçimlerini kullanır.

Yedi adımın hepsi başarılı olsa da davranış hala yanlış görünüyorsa, bir istek/yanıt çiftini (anahtar bilgileri gizlenmiş olarak) kaydedin ve destek ekibine gönderin.