한눈에 보기
실무에서 달라지는 점
01
인증 및 범위
X-Mosaqo-API-Key에 비밀을 보냅니다. 사용 가능한 범위에는 qr:read, qr:write, 내보내기:읽기 및 분석:읽기가 포함됩니다. 키는 만료되거나 취소되거나 IP 허용 목록을 사용할 수 있습니다.
- 클라이언트 JavaScript에 비밀을 두지 마십시오.
- 통합당 하나의 키 사용
- 노출 의심 후 회전
02
안전한 쓰기 재시도
생성 및 게시 요청에는 1~128자 사이의 멱등성 키가 필요합니다. 24시간 이내에 동일한 페이로드를 다시 시도하는 경우에만 키를 재사용하세요.
03
속도 제한 및 오류
HTTP 429에서 Retry-After를 읽고 백오프로 다시 시도하세요. 401은 일반적으로 누락, 취소, 만료, 제한 또는 범위가 부족한 키를 나타냅니다.
04
웹훅
필요한 이벤트만 구독하고 HTTPS에서 수락하고 빠르게 응답하세요. Mosaqo는 배송 상태를 기록하고 작업 공간에서 재생을 지원합니다.
FAQ
자주 묻는 질문
전체 API 계약은 어디에 있나요?
OpenAPI 3.1 계약은 Mosaqo API 버전으로 구성됩니다. 웹 작업 공간에서 키를 생성하고 게시된 계약을 사용하여 엔드포인트 세부 정보를 확인하세요.
다음 단계