리셀러/연동 체크리스트
리셀러 체크리스트
Wokey API를 자체 하위 사용자에게 재판매한다면 아래 목록을 순서대로 확인하세요. 각 항목은 자세한 설명으로 연결됩니다.
체크리스트link
- 1
모든 요청에
X-End-User-Id보내기하나의 키로 여러 최종 사용자에게 서비스할 때, 이 헤더는 요청이 어느 최종 사용자의 것인지 알려 줍니다. 한 최종 사용자가 계속 위반하면 Wokey는 그 사용자만 제한하고 다른 사용자는 계속 이용할 수 있습니다. 엔터프라이즈 계정과 리셀러 계정은 콘솔에서 제한된 사용자를 확인하고 제한을 해제할 수도 있습니다.
- 2
모델 거부 감지하기
거부된 경우에도 HTTP 200이 반환되므로 응답의 필드로 감지해야 합니다. 거부를 감지하면 같은 요청을 재시도하지 말고 사용자에게 내용을 수정하도록 안내하세요.
- 3
위반 사용자를 조기에 차단하기
거부가 반복되면 속도 제한, 모델 정지, 위반 수수료로 이어집니다.
X-End-User-Id사용 여부와 관계없이 위반은 귀하의 계정에 집계되므로, Wokey로 요청을 보내기 전에 콘텐츠를 필터링하세요. - 4
상태 코드별로 오류 처리하기
잔액 부족(402), 속도 제한(429), 업스트림 오류(502, 504, 529)를 구분하고 그에 맞게 안내하거나 재시도하세요. 고객 지원에 문의할 때는
x-wokey-request-id응답 헤더를 함께 보내 주세요. - 5
잔액과 사용량 모니터링하기
계정 잔액은
/v1/dashboard/balance로, 키별 사용량과 남은 한도는/v1/usage와/v1/key로 조회합니다. 잔액이 소진되기 전에 충전하세요. - 6