v1

latestOpenAPI 3.0.2서비스 이용약관2026-07-265758331.1 KB

SMS

문자 메시지 발송 상세 조회

특정 메시지 그룹의 발송 요청 상세 정보를 조회합니다.

get/v2/messages/sms/groups/{groupId}

Path parameters

groupIdstring required

메시지 그룹의 ID입니다.

Response

문자 메시지 발송 상세 조회가 성공적으로 완료되었습니다. 요청한 메시지의 발송 상태와 정보가 반환됩니다.

codenumber required

HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.

messagestring required

API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "성공", 실패 시 구체적인 오류 사유가 포함됩니다.

Example response

{
  "code": 200,
  "message": "성공",
  "data": {
    "groupId": "004a6217-f06c-40f6-8f39-bf35b3f76111",
    "channelId": "1",
    "contactsGroups": [
      "1111",
      "2222"
    ],
    "contactsMemberId": [
      "1111",
      "2222"
    ],
    "countRequest": 1000,
    "title": "중요한 안내 사항",
    "message": "안녕하세요. 문자 메시지 발송 테스트입니다.",
    "messageType": "SMS",
    "requestIp": "192.168.1.100",
    "senderNumber": "01087654321",
    "repeatCount": 5,
    "repeatInterval": 10,
    "repeatUnit": "MINUTE",
    "repeatStartTime": "2024-01-15T10:00:00Z",
    "userId": "12345",
    "isUseApi": true,
    "imageIds": [
      "IMG019048efaefa7d888ae9801406be243a",
      "IMG019048efaefa7d888ae9801406be243b"
    ],
    "messageCount": 950,
    "standbyCount": 50,
    "sendingCount": 100,
    "succeededCount": 800,
    "failedCount": 50,
    "canceledCount": 10,
    "blockedCount": 5,
    "pointId": "point_12345",
    "usedPoints": 1100,
    "refundPoints": 550,
    "usedNetPoints": 1000,
    "refundNetPoints": 500,
    "usedVatPoints": 100,
    "refundVatPoints": 50,
    "unitCost": "10.0",
    "groupStatus": "COMPLETED",
    "reservedStatus": "RESERVED",
    "cancelStatus": "CANCELED",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}