v1

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

SMS

분할 예약 목록 조회

예약된 문자 메시지의 분할 발송 목록을 조회합니다. 대용량 발송을 위한 분할 예약 정보를 확인할 수 있습니다.

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

Path parameters

groupIdstring required

메시지 그룹의 ID입니다.

Query parameters

limitnumber

한 번에 조회할 분할의 최대 개수입니다. 최소 1개부터 최대 100개까지 설정 가능하며, 기본값은 30개입니다.

cursorstring

다음 페이지를 요청할 때 사용할 커서 값입니다. 첫 번째 페이지 요청 시에는 생략하세요.

Response

분할 예약 목록 조회가 성공적으로 완료되었습니다. 분할별 예약 정보와 페이지네이션 정보가 반환됩니다.

codenumber required

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

messagestring required

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

Example response

{
  "code": 200,
  "message": "성공",
  "data": {
    "items": [
      {
        "groupId": "004a6217-f06c-40f6-8f39-bf35b3f76111",
        "repeatId": "repeat_001",
        "repeatStatus": "RESERVED",
        "cancelRequestTime": "2024-01-15T09:45:00Z",
        "cancelRequestIp": "192.168.1.100",
        "cancelTime": "2024-01-15T09:50:00Z",
        "repeatSendTime": "2024-01-15T14:00:00Z",
        "messageCount": 1000,
        "startMessageId": 1001,
        "endMessageId": 2000,
        "succeededCount": 950,
        "failedCount": 50,
        "canceledCount": 20
      }
    ],
    "cursor": "cursor_repeat_12345"
  }
}