멱등키 사용

멱등키 사용하기

요청 헤더에 smartro-idempotency-key : {멱등키} 를 추가하면 멱등한 요청을 보낼 수 있습니다.

멱등키는 UUID와 같이 충분히 무작위적인 고유 값으로 생성해주세요. 최대 길이는 255자입니다.

멱등키는 처음 요청에 사용한 날부터 15일 간 유효합니다. 처음 요청한 날부터 15일이 지났다면 새로운 멱등키로 요청하세요.

클라이언트가 헤더로 보낸 멱등키와 API 키, URI를 확인해서 멱등성을 보장합니다. 따라서 API 키, URI가 다르다면 같은 멱등키를 사용해도 괜찮습니다.

			
			POST https://{API 도메인}/{uri}
			content-type : application/json
			accept : application/json
			accept-charset : UTF-8
			apikey : {apikey}
			smartro-idempotency-key : {멱등키}
			
			{
			↔
			}

에러 처리하기

HTTP Status Code	에러 코드	메시지
400	INVALID_IDEMPOTENCY_KEY	멱등키는 255자 이하여야 합니다.
409	IDEMPOTENT_REQUEST_PROCESSING	이전 멱등 요청이 처리중입니다.

			
			HTTP/1.1 409
			
			{
			"code":"IDEMPOTENT_REQUEST_PROCESSING",
			"message":"이전 멱등 요청이 처리중입니다."
			}