SaaS API전자계약 API
POST /ai/contract/{contractId}/otp/send
서명을 위한 SMS OTP 인증번호를 발송합니다.
OTP 발송 요청
서명 전 본인인증을 위한 SMS OTP 인증번호를 발송합니다.
| 항목 | 값 |
|---|---|
| 메서드 | POST |
| 경로 | /ai/contract/{contractId}/otp/send |
| 인증 | Bearer Token (크리에이터) |
FILLED또는OTP_VERIFIED상태에서만 요청 가능합니다.- 인증번호는 3분간 유효합니다.
- 10분 내 최대 3회까지 요청 가능합니다.
요청
POST /ai/contract/1/otp/send HTTP/1.1
Host: api.glowb.com
Authorization: Bearer {access_token}curl -X POST "https://api.glowb.com/ai/contract/1/otp/send" \
-H "Authorization: Bearer {access_token}"const response = await fetch('/ai/contract/1/otp/send', {
method: 'POST',
headers: {
'Authorization': `Bearer ${accessToken}`,
},
});
const result = await response.json();Path Parameters
Prop
Type
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "인증번호가 발송되었습니다.",
"data": null
}에러 응답
상태 오류 (400)
{
"status": 400,
"code": "CONTRACT_INVALID_STATE",
"message": "현재 상태에서는 OTP를 요청할 수 없습니다.",
"data": null
}요청 제한 초과 (429)
{
"status": 429,
"code": "CONTRACT_OTP_RATE_LIMIT",
"message": "OTP 요청이 너무 많습니다. 잠시 후 다시 시도해주세요.",
"data": null
}SMS 발송 실패 (500)
{
"status": 500,
"code": "CONTRACT_SMS_SEND_FAILED",
"message": "인증 문자 발송에 실패했습니다.",
"data": {
"resultCode": -101,
"resultMessage": "잔액부족"
}
}data.resultCode와 data.resultMessage는 Aligo SMS API의 실제 에러 코드와 메시지입니다.
네트워크 오류 등 Aligo API 호출 자체가 실패한 경우 resultCode: -999로 반환됩니다.