Açık API Genel Bakışı
Kimlik doğrulama yöntemleri, yanıt biçimi, hata kodları ve desteklenen dil kodları.
Aşağıdaki {API}, hizmet adresini belirtir; yönetim panelindeki “Entegrasyon” sayfasında görülebilir.
Tüm isteklerde Authorization: Bearer sk_live_... bulunur (yönetim panelindeki “Entegrasyon” sayfasında oluşturulur, yalnızca bir kez gösterilir ve yalnızca sunucuda saklanmalıdır).
Yanıtlar her zaman {"code": "SUCCESS", "message": "", "data": ...} biçimindedir. Hata durumunda code sabit bir hata kodudur; buna göre karar verin. message yalnızca insanların okuması içindir. Tutarlar her zaman string olarak verilir.
Hata kodları
| code | Senaryo |
|---|---|
UNAUTHORIZED | API Key geçersiz veya iptal edilmiş |
VALIDATION_ERROR | Parametreler hatalı; data içinde ilgili alanlar belirtilir |
NOT_FOUND | Kaynak bulunamadı (size ait olmayan kaynaklar dahil) |
PLAN_LIMIT_REACHED | Paketteki ürün sayısı, bilgi tabanı kapasitesi veya temsilci koltuğu sayısı aşıldı |
CONVERSATION_CLOSED | Görüşme sona erdi; yeni bir görüşme başlatın |
CONVERSATION_OPEN | Görüşme henüz sona ermedi; değerlendirme yapılamaz |
RATE_LIMITED | İstek sıklığı çok yüksek |
USER_TOKEN_INVALID | user_token imzası geçersiz veya süresi dolmuş |
CHECKOUT_FAILED | Sipariş onayı geçersiz veya süresi dolmuş ya da sipariş verme API'si geçici olarak kullanılamıyor (widget'ta “Siparişi Onayla” düğmesine tıklandığında) |
ORIGIN_NOT_ALLOWED | Mevcut web sitesi, gömülmeye izin verilenler listesinde değil |
LANGUAGE_NOT_SUPPORTED | Bu dil desteklenmiyor veya etkinleştirilmemiş |
CHANNEL_CHECK_FAILED | Kanalın AppID / AppSecret doğrulaması başarısız; message içinde WeChat'in döndürdüğü neden yer alır |
CHANNEL_REMOVED | Görüşmenin geldiği kanal silinmiş; yanıt gönderilemiyor |
Desteklenen dil kodları: zh-CN, zh-TW, en, ja, ko, de, fr, es, pt, it, ru, ar, th, vi, id, ms, tr, nl, pl. zh-Hant, pt-BR, en_US gibi yazımlar otomatik olarak ilgili kodlara dönüştürülür.
Bu sayfa yardımcı oldu mu?
Son güncelleme:
