Panoramica API aperte
Metodi di autenticazione, formato delle risposte, codici di errore e codici delle lingue supportate.
Il {API} che segue indica l'indirizzo del servizio, che puoi vedere nella pagina «Integrazione» del pannello di controllo.
Tutte le richieste includono Authorization: Bearer sk_live_... (creata nella pagina «Integrazione» del pannello di controllo, viene mostrata una sola volta e va conservata esclusivamente sul server).
Le risposte hanno sempre il formato {"code": "SUCCESS", "message": "", "data": ...}. In caso di errore, code è un codice stabile: usa quello per decidere; message serve solo alle persone. Gli importi sono sempre stringhe.
Codici di errore
| code | Scenario |
|---|---|
UNAUTHORIZED | API Key non valida o revocata |
VALIDATION_ERROR | Parametri non corretti, data contiene i campi specifici |
NOT_FOUND | Risorsa inesistente (anche risorse che non ti appartengono) |
PLAN_LIMIT_REACHED | Superato il limite di prodotti, capacità della knowledge base o numero di operatori del piano |
CONVERSATION_CLOSED | La conversazione è terminata, creane una nuova |
CONVERSATION_OPEN | La conversazione non è ancora terminata, non è possibile lasciare una valutazione |
RATE_LIMITED | Troppe richieste |
USER_TOKEN_INVALID | La firma di user_token non è valida o è scaduta |
CHECKOUT_FAILED | La conferma dell'ordine è scaduta, oppure l'API di creazione ordine non è temporaneamente raggiungibile (quando nel widget si clicca «Conferma ordine») |
ORIGIN_NOT_ALLOWED | Il sito attuale non è nell'elenco di quelli autorizzati all'incorporamento |
LANGUAGE_NOT_SUPPORTED | Lingua non supportata o non abilitata |
CHANNEL_CHECK_FAILED | La verifica di AppID / AppSecret del canale non è andata a buon fine; message riporta il motivo restituito da WeChat |
CHANNEL_REMOVED | Il canale da cui proviene la conversazione è stato eliminato, non è possibile inviare risposte |
Codici delle lingue supportate: zh-CN, zh-TW, en, ja, ko, de, fr, es, pt, it, ru, ar, th, vi, id, ms, tr, nl, pl. Formati come zh-Hant, pt-BR, en_US vengono convertiti automaticamente nel codice corrispondente.
Questa pagina ti è stata utile?
Ultimo aggiornamento:
