오픈 API 개요
인증 방식, 응답 형식, 오류 코드 및 지원되는 언어 코드.
아래의 {API}는 서비스 주소를 의미하며, 관리자 페이지의 '연동' 페이지에서 확인할 수 있습니다.
모든 요청에는 Authorization: Bearer sk_live_...가 포함됩니다(관리자 페이지의 '연동' 페이지에서 생성되며, 한 번만 표시되므로 서버에만 보관하세요).
응답은 모두 {"code": "SUCCESS", "message": "", "data": ...} 형식입니다. 실패 시 code는 안정적인 오류 코드이므로 이를 기준으로 판단하세요. message는 사람이 읽기 위한 정보입니다. 금액은 항상 문자열입니다.
오류 코드
| code | 상황 |
|---|---|
UNAUTHORIZED | API Key가 유효하지 않거나 폐기됨 |
VALIDATION_ERROR | 파라미터가 올바르지 않으며, data에 구체적인 필드가 있음 |
NOT_FOUND | 리소스가 존재하지 않음(소유하지 않은 리소스도 포함) |
PLAN_LIMIT_REACHED | 플랜의 상품 수, 지식 베이스 용량 또는 좌석 수를 초과함 |
CONVERSATION_CLOSED | 대화가 종료되었으므로 새로 생성하세요 |
CONVERSATION_OPEN | 대화가 아직 종료되지 않아 평가할 수 없음 |
RATE_LIMITED | 요청이 너무 많음 |
USER_TOKEN_INVALID | user_token 서명이 올바르지 않거나 만료됨 |
CHECKOUT_FAILED | 주문 확인이 만료되었거나 주문 생성 API에 일시적으로 연결할 수 없음(widget에서 '주문 확인'을 클릭할 때) |
ORIGIN_NOT_ALLOWED | 현재 웹사이트가 임베드 허용 목록에 없음 |
LANGUAGE_NOT_SUPPORTED | 지원하지 않거나 이 언어가 활성화되지 않음 |
CHANNEL_CHECK_FAILED | 채널의 AppID / AppSecret 검증에 실패함, message에 WeChat이 반환한 이유가 있음 |
CHANNEL_REMOVED | 대화가 시작된 채널이 삭제되어 답장을 보낼 수 없음 |
지원하는 언어 코드: 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와 같은 표기는 해당 코드로 자동 변환됩니다.
이 페이지가 도움이 되었나요?
마지막 업데이트:
