참조

멱등 요청

네트워크가 실패할 수 있어요. 전송 요청이 시간 초과되면 요청이 수락되었는지 알 수 없어요. POST /v1/messages와 POST /v1/batches를 Idempotency-Key 헤더와 함께 보내고, 동일한 키로 재시도하세요.

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-55102-shipped" \
  -d '{"to": "+14155550123", "text": "Order 55102 has shipped."}'

규칙

키는 최대 255자까지 가능한 문자열이에요. 이벤트를 나타내는 이름을 사용하세요: 주문 ID와 단계, 또는 첫 시도 전에 생성한 UUID 등이 좋아요.
수락된 요청(202)은 계정당 24시간 동안 기억돼요. 동일한 키와 동일한 본문으로 요청하면 첫 번째 응답이 다시 반환되고, Idempotent-Replayed: true 헤더가 추가되며, 아무것도 전송되지 않아요.
동일한 키에 다른 본문이 있으면 409 idempotency_conflict가 반환돼요.
에러로 실패한 요청은 기억되지 않아요. 그래서 문제를 수정한 후 같은 키로 다시 시도할 수 있어요.

이전요청 한도 다음코드 샘플