ALL4SMS API 문서

POST /api/sms/send

요청 본문

매개변수	타입	필수	설명
recipient	string	필수	수신자 전화번호. 여러 형식 지원: 단일 번호: "821012345678" 여러 번호: "821012345678,821098765432" 줄바꿈으로 구분: "821012345678\n821098765432" 허용 형식: 8210..., 010..., 10...
message	string	필수	SMS 메시지 내용 (최대 70자). 한글, 이모지, 특수문자 모두 포함하여 70자로 제한

요청 예시

{
    "recipient": "821012345678,821098765432",
    "message": "안녕하세요! 테스트 메시지입니다 (70자 미만)"
}

성공 응답

{
    "success": true,
    "message": "SMS 전송 대기 중",
    "data": {
        "reference_code": "REF20230531123456789",
        "message_id": 12345,
        "group_id": 456789,
        "sender": "821098765432",
        "total_cost": 2,
        "remaining_balance": 98,
        "recipient_count": 2,
        "sms_count": 2,
        "status": "대기 중",
        "message_length": 45
    }
}

에러 응답

400 Bad Request - 메시지 길이 초과

{
    "success": false,
    "error": "메시지가 70자 제한을 초과했습니다 (현재: 85자)"
}

400 Bad Request - 수신자 수 초과

{
    "success": false,
    "error": "요청당 최대 30명의 수신자",
    "max_recipients": 30
}

400 Bad Request - 잔액 부족

{
    "success": false,
    "error": "잔액 부족"
}

참고 사항

• 모든 메시지는 최대 70자로 제한됩니다 (한글, 이모지, 특수문자, 공백, 줄바꿈 모두 포함)
• 70자를 초과하는 메시지는 자동으로 거부됩니다
• 각 메시지는 정확히 1개 SMS로 계산됩니다
• 유효하지 않은 번호는 감지되지만 요금이 청구되지 않습니다
• 각 요청은 최대 30명의 수신자를 가질 수 있습니다
• 발신 번호는 유효한 한국 번호로 무작위 생성됩니다

GET /api/sms/status

쿼리 매개변수

매개변수	타입	필수	설명
message_id	integer	필수*	SMS 발송 엔드포인트에서 반환된 메시지 ID
reference_code	string	필수*	message_id 대신 사용 가능, 발송 응답의 참조 코드

* message_id 또는 reference_code 중 하나는 반드시 제공되어야 합니다

요청 예시

GET /api/sms/status?message_id=12345

성공 응답

{
    "success": true,
    "data": [
        {
            "id": 12345,
            "recipient": "821012345678",
            "status": "전송 완료",
            "delivery_time": "2023-05-31 12:34:56",
            "error_code": null,
            "error_message": null
        },
        {
            "id": 12346,
            "recipient": "821098765432",
            "status": "전송 실패",
            "delivery_time": null,
            "error_code": "INVALID_NUMBER",
            "error_message": "수신자 번호가 유효하지 않습니다"
        }
    ]
}

상태 코드

상태	설명
대기 중	메시지가 전송 대기 중입니다(일반적으로 몇 초 내)
전송 중	메시지가 통신사 네트워크로 전송되었습니다
전송 완료	메시지가 수신자 기기로 전달되었습니다
전송 실패	메시지 전송에 실패했습니다(자세한 내용은 error_code 확인)
유효하지 않은 번호	수신자 번호가 유효하지 않거나 서비스 중이 아닙니다

GET /api/user/balance

요청 예시

GET /api/user/balance

성공 응답

{
    "success": true,
    "data": {
        "credit_balance": 98,
        "pending_charges": 2,
        "effective_balance": 96,
        "last_transaction": {
            "date": "2023-05-30",
            "amount": 100,
            "type": "구매"
        }
    }
}

메시지 내용	문자 수	세그먼트	비용
"Hello World" (11 ASCII)	11	1	1 크레딧
"안녕하세요" (5 한글)	5	1	1 크레딧
160 ASCII 문자	160	1	1 크레딧
161 ASCII 문자	161	2	2 크레딧
70 한글 문자	70	1	1 크레딧
71 한글 문자	71	2	2 크레딧