쿨에스엠에스
  • Documents for COOLSMS Developers
  • AUTHENTICATION
    • Overview
    • API Key 인증 방식
    • OAuth2 인증 방식
      • 적용하기
      • 권한(Scope) 목록
    • 멤버 권한 목록
  • DEVELOPMENT-KITS
    • C#
    • DB연동 Agent
    • Go
    • Java
    • Node JS
    • Others
    • PHP
    • Python
    • Ruby
    • Visual Basic .NET
    • Visual Basic 6
  • APP-STORE
    • 쿨에스엠에스 OAuth2 연동 Node & Express를 이용하여 앱 만들기
    • 쿨에스엠에스 앱 스토어에 내가 만든 앱 등록하기
  • API REFERENCE
    • Overview
    • 메시지
      • 여러건 발송
      • 단일 메시지
      • 그룹 메시지
        • 그룹 생성
        • 그룹 메시지 추가
        • 그룹 메시지 목록 조회
        • 그룹 메시지 삭제
        • 발송 요청
        • 그룹 목록 조회
        • 그룹 정보 조회
        • 그룹 삭제
      • 메시지 조회
      • 통계 조회
      • 통계 엑셀 파일 다운로드
    • 카카오톡
      • 템플릿을 삭제
      • 카테고리 정보 조회
      • 카카오톡채널 조회
      • 카카오톡채널 목록 조회
      • 템플릿 정보 조회
      • 템플릿 목록 조회
      • 템플릿 숨김 설정
      • 카카오톡채널 추가
      • 템플릿 추가
      • 템플릿 댓글 추가
      • 카카오톡채널 연동 토큰 신청
      • 템플릿 정보 수정
      • 템플릿 검수 요청
    • 잔액
      • 잔액이전
      • 사용자 충전
      • 은행 계좌 등록
      • 결제수단 등록
      • 출금 신청
      • 등록된 계좌 정보 삭제
      • 결제 수단 제거
      • 잔액조회
      • 잔액 변동내역 조회
      • 계좌 정보 조회
      • 견적서 발급
      • 알림 설정 조회
      • 결제수단 목록 조회
      • 거래명세서 발급
      • 출금 요청 상태 조회
      • 등록된 결제수단의 우선순위를 변경
      • 잔액 소진 알림 설정
      • 잔액 소진 알림 on/off 설정
      • 자동 충전 on/off
    • 가격
      • 하나의 국가의 메시지 단가 가져오기
      • 국가별 메시지 가격 리스트 가져오기
    • 스토리지
      • 파일 삭제
      • 파일 조회
      • 파일 목록 조회
      • 파일 업로드
    • 메시지 상태 코드
    • Terminology
  • OLD-VERSIONS
    • SMS API Version 1
    • SMS API Version 2
  • OLD-VERSIONS-SDK
    • C
    • Delphi
      • API Reference
      • Examples
    • java
    • JAVA
    • java
    • PHP
      • PHP SDK v2
        • Example
    • python
    • Python
    • python
    • 에러코드 참고
Powered by GitBook
On this page
  • Request
  • Authorization 인증 필요 [?]
  • Query Params
  • Response
  • Response Structure
  • Response Description
  • Samples
  • 메시지 그룹 목록 get /messages/v4/groups
Export as PDF
  1. API REFERENCE
  2. 메시지
  3. 그룹 메시지

그룹 목록 조회

Previous발송 요청Next그룹 정보 조회

Last updated 3 years ago

Request

GET https://api.coolsms.co.kr/messages/v4/groups

메시지 그룹 목록을 조회합니다.

Authorization 인증 필요

계정 권한

회원 권한

계정 상태

회원 상태

계정 인증

message:read

role-message:read

ACTIVE

ACTIVE

Query Params

Name

Type

Required

Description

criteria

string

eq

검색 조건에 사용되는 필드명 criteria 의 값은 'key1,key2,key3' 과 같이 ,(콤마) 로 구분되며 cond, value 와 함께 사용됩니다. - messageId - 메시지 아이디 입니다. - groupId - 그룹 아이디 입니다. - to - 수신 번호 입니다. - from - 발신 번호 입니다. - type - 문자 메시지의 타입 입니다. (SMS, LMS, MMS, ATA, CTA, CTI) - dateCreated - 그룹 생성일 입니다. - dateUpdated - 그룹 정보를 변경한 마지막 시각 입니다. - replacement - 대체 발송 여부 입니다. (true, false) - statusCode - 문자 메시지의 상태 코드 입니다.

cond

string

eq

검색 조건에 사용되는 연산자 criteria 와 같이 'cond1,cond2' 와 같이 ,(콤마)로 구분되며, criteria,value 와 함께 사용됩니다. - eq - 같음 (=) - ne - 같지 않음 (!=) - gt - 보다 큼 (>) - gte - 보다 크거나 같음 (>=) - lt - 보다 작음 (<) - lte - 보다 작거나 같음 (<=)

value

string

eq

검색 값 criteria , cond 값에 대응하는 value 입니다. criteria='messageId,statusCode' cond='eq,eq' 일 경우 groupId 에 대응하는 value 값을 찾고 status 에 대응하는 값을 찾는 조건 입니다. e.g - value='메시지아이디,2000'

startKey

string

eq

현재 목록을 불러올 기준이 되는 키

limit

number

eq

한 페이지에 불러옥 목록 개수

dateType

string

eq

설명 없음

startDate

date

eq

검색 시작 날짜

endDate

date

eq

검색 끝 날짜

Response

Response Structure

{
    "startKey": "string",
    "limit": "number",
    "nextKey": "string",
    "groupList": {
        "groupId": {
            "count": {
                "total": "number",
                "sentTotal": "number",
                "sentFailed": "number",
                "sentSuccess": "number",
                "sentPending": "number",
                "sentReplacement": "number",
                "refund": "number",
                "registeredFailed": "number",
                "registeredSuccess": "number"
            },
            "balance": {
                "requested": "number",
                "replacement": "number",
                "refund": "number",
                "sum": "number"
            },
            "point": {
                "requested": "number",
                "replacement": "number",
                "refund": "number",
                "sum": "number"
            },
            "app": {
                "profit": {
                    "sms": "number",
                    "lms": "number",
                    "mms": "number",
                    "ata": "number",
                    "cta": "number",
                    "cti": "number",
                    "nsa": "number",
                    "rcs_sms": "number",
                    "rcs_lms": "number",
                    "rcs_mms": "number",
                    "rcs_tpl": "number"
                },
                "appId": "string",
                "version": "string"
            },
            "sdkVersion": "string",
            "osPlatform": "string",
            "log": [
                {
                    "message": "object",
                    "createAt": "date"
                }
            ],
            "status": "any",
            "scheduledDate": "date",
            "dateSent": "date",
            "dateCompleted": "date",
            "isRefunded": "boolean",
            "flagUpdated": "boolean",
            "groupId": "string",
            "accountId": "string",
            "apiVersion": "string",
            "countForCharge": {
                "sms": {
                    "country": "number"
                },
                "lms": {
                    "country": "number"
                },
                "mms": {
                    "country": "number"
                },
                "ata": {
                    "country": "number"
                },
                "cta": {
                    "country": "number"
                },
                "cti": {
                    "country": "number"
                },
                "nsa": {
                    "country": "number"
                },
                "rcs_sms": {
                    "country": "number"
                },
                "rcs_lms": {
                    "country": "number"
                },
                "rcs_mms": {
                    "country": "number"
                },
                "rcs_tpl": {
                    "country": "number"
                }
            },
            "price": {},
            "dateCreated": "date",
            "dateUpdated": "date"
        }
    }
}

Response Description

Response /

Name

Type

Should Return

Description

startKey

string

현재 목록을 불러올 기준이 되는 키

limit

number

한 페이지에 불러옥 목록 개수

nextKey

string

다음 목록을 불러올 수 있는 키

object

그룹 목록

Response / groupList

Name

Type

Should Return

Description

string

그룹 아이디

Response / groupList / groupId

Name

Type

Should Return

Description

object

카운트

number

잔액

number

포인트

object

앱 정보

sdkVersion

string

SDK 버전

osPlatform

string

OS / Platform

Array

로그

status

any

그룹 상태 PENDING - 대기중 SENDING - 이미 발송 요청된 그룹 DELETED - 삭제 처리된 그룹 FAILED - 실패 처리된 그룹 COMPLETE - 발송 완료된 그룹 SCHEDULED - 발송 예약된 그룹

scheduledDate

date

설명 없음

dateSent

date

발송 일시

dateCompleted

date

완료 일시

isRefunded

boolean

환급 여부

flagUpdated

boolean

업데이트 여부

groupId

string

그룹 아이디

accountId

string

계정 고유 번호

apiVersion

string

API 버전

object

차감 카운트

any

단가

dateCreated

date

생성 일시

dateUpdated

date

업데이트 일시

Response / groupList / groupId / count

Name

Type

Should Return

Description

total

number

토탈

sentTotal

number

전체 발송 건수

sentFailed

number

발송 실패 건수

sentSuccess

number

발송 성공 건수

sentPending

number

대기 건수

sentReplacement

number

대체 발송 건수

refund

number

환급 건수

registeredFailed

number

접수 실패 건수

registeredSuccess

number

접수 성공 건수

Response / groupList / groupId / balance

Name

Type

Should Return

Description

requested

number

차감 금액

replacement

number

대체 발송 금액

refund

number

환급 금액

sum

number

합계 금액

Response / groupList / groupId / point

Name

Type

Should Return

Description

requested

number

차감 포인트

replacement

number

대체 발송 포인트

refund

number

환급 포인트

sum

number

합계 포인트

Response / groupList / groupId / app

Name

Type

Should Return

Description

object

앱 사용 요금

appId

string

앱 아이디

version

string

앱 버전

Response / groupList / groupId / app / profit

Name

Type

Should Return

Description

sms

number

SMS 사용 요금

lms

number

LMS 사용 요금

mms

number

MMS 사용 요금

ata

number

알림톡 사용 요금

cta

number

친구톡 사용 요금

cti

number

친구톡 이미지 사용 요금

nsa

number

네이버 스마트 알림 사용 요금

rcs_sms

number

RCS SMS 사용 요금

rcs_lms

number

RCS LMS 사용 요금

rcs_mms

number

RCS MMS 사용 요금

rcs_tpl

number

RCS 템플릿 사용 요금

Response / groupList / groupId / log

Name

Type

Should Return

Description

message

object

로그 메시지

createAt

date

로그 기록 일시

Response / groupList / groupId / countForCharge

Name

Type

Should Return

Description

object

SMS 차감 건수

object

LMS 차감 건수

object

MMS 차감 건수

object

알림톡 차감 건수

object

친구톡 차감 건수

object

친구톡 이미지 차감 건수

object

네이버 스마트 알림 차감 건수

object

RCS SMS 차감 건수

object

RCS LMS 차감 건수

object

RCS MMS 차감 건수

object

RCS 템플릿 차감 건수

Response / groupList / groupId / countForCharge / sms

Name

Type

Should Return

Description

country

number

국가별 SMS 차감 건수

Response / groupList / groupId / countForCharge / lms

Name

Type

Should Return

Description

country

number

국가별 LMS 차감 건수

Response / groupList / groupId / countForCharge / mms

Name

Type

Should Return

Description

country

number

국가별 MMS 차감 건수

Response / groupList / groupId / countForCharge / ata

Name

Type

Should Return

Description

country

number

국가별 알림톡 차감 건수

Response / groupList / groupId / countForCharge / cta

Name

Type

Should Return

Description

country

number

국가별 친구톡 차감 건수

Response / groupList / groupId / countForCharge / cti

Name

Type

Should Return

Description

country

number

국가별 친구톡 이미지 차감 건수

Response / groupList / groupId / countForCharge / nsa

Name

Type

Should Return

Description

country

number

국가별 네이버 스마트 알림 차감 건수

Response / groupList / groupId / countForCharge / rcs_sms

Name

Type

Should Return

Description

country

number

국가별 RCS SMS 차감 건수

Response / groupList / groupId / countForCharge / rcs_lms

Name

Type

Should Return

Description

country

number

국가별 RCS LMS 차감 건수

Response / groupList / groupId / countForCharge / rcs_mms

Name

Type

Should Return

Description

country

number

국가별 RCS MMS 차감 건수

Response / groupList / groupId / countForCharge / rcs_tpl

Name

Type

Should Return

Description

country

number

국가별 RCS 템플릿 차감 건수

Response / groupList / groupId / price

Name

Type

Should Return

Description

Samples

메시지 그룹 목록 get /messages/v4/groups

Sample Request

http://api.coolsms.co.kr/messages/v4/groups?limit=10

Sample Response

{
    "startKey": null,
    "limit": 10,
    "groupList": {
        "G4VZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ": {
            "_id": "G4VZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ",
            "count": {
                "total": 0,
                "sentTotal": 0,
                "sentFailed": 0,
                "sentSuccess": 0,
                "sentPending": 0,
                "sentReplacement": 0,
                "refund": 0,
                "registeredFailed": 0,
                "registeredSuccess": 0
            },
            "balance": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "point": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "app": {
                "profit": {
                    "sms": 0,
                    "lms": 0,
                    "mms": 0,
                    "ata": 0,
                    "cta": 0,
                    "cti": 0,
                    "nsa": 0,
                    "rcs_sms": 0,
                    "rcs_lms": 0,
                    "rcs_mms": 0,
                    "rcs_tpl": 0
                },
                "appId": null,
                "version": null
            },
            "serviceMethod": "MT",
            "sdkVersion": null,
            "osPlatform": null,
            "log": [
                {
                    "createAt": "2021-07-14T07:12:41.935Z",
                    "message": "메시지 그룹이 생성되었습니다."
                }
            ],
            "status": "PENDING",
            "dateSent": null,
            "scheduledDate": null,
            "dateCompleted": null,
            "isRefunded": false,
            "flagUpdated": false,
            "prepaid": true,
            "strict": true,
            "masterAccountId": null,
            "allowDuplicates": false,
            "groupId": "G4VZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ",
            "accountId": "12925149",
            "apiVersion": "4",
            "countForCharge": {
                "sms": {
                    "82": 0
                },
                "lms": {},
                "mms": {},
                "ata": {},
                "cta": {},
                "cti": {},
                "nsa": {},
                "rcs_sms": {},
                "rcs_lms": {},
                "rcs_mms": {},
                "rcs_tpl": {}
            },
            "price": {},
            "customFields": {},
            "hint": {},
            "dateCreated": "2021-07-14T07:12:41.937Z",
            "dateUpdated": "2021-07-14T07:12:41.937Z"
        },
        "G4V20210714161242N9LDHCHSXGUN79M": {
            "_id": "G4V20210714161242N9LDHCHSXGUN79M",
            "count": {
                "total": 0,
                "sentTotal": 0,
                "sentFailed": 0,
                "sentSuccess": 0,
                "sentPending": 0,
                "sentReplacement": 0,
                "refund": 0,
                "registeredFailed": 0,
                "registeredSuccess": 0
            },
            "countForCharge": {
                "sms": {},
                "lms": {},
                "mms": {},
                "ata": {},
                "cta": {},
                "cti": {},
                "nsa": {},
                "rcs_sms": {},
                "rcs_lms": {},
                "rcs_mms": {},
                "rcs_tpl": {}
            },
            "balance": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "point": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "app": {
                "profit": {
                    "sms": 0,
                    "lms": 0,
                    "mms": 0,
                    "ata": 0,
                    "cta": 0,
                    "cti": 0,
                    "nsa": 0,
                    "rcs_sms": 0,
                    "rcs_lms": 0,
                    "rcs_mms": 0,
                    "rcs_tpl": 0
                },
                "appId": null,
                "version": null
            },
            "serviceMethod": "MT",
            "sdkVersion": null,
            "osPlatform": null,
            "log": [
                {
                    "createAt": "2021-07-14T07:12:42.320Z",
                    "message": "[::ffff:127.0.0.1] 메시지 그룹이 생성되었습니다."
                }
            ],
            "status": "PENDING",
            "dateSent": null,
            "scheduledDate": null,
            "dateCompleted": null,
            "isRefunded": false,
            "flagUpdated": false,
            "prepaid": true,
            "strict": false,
            "masterAccountId": null,
            "allowDuplicates": false,
            "accountId": "12925149",
            "apiVersion": "4",
            "customFields": {},
            "hint": null,
            "groupId": "G4V20210714161242N9LDHCHSXGUN79M",
            "price": {},
            "dateCreated": "2021-07-14T07:12:42.323Z",
            "dateUpdated": "2021-07-14T07:12:42.323Z"
        },
        "G4V20210714161242KALYJKJ9VLVMJKR": {
            "_id": "G4V20210714161242KALYJKJ9VLVMJKR",
            "count": {
                "total": 0,
                "sentTotal": 0,
                "sentFailed": 0,
                "sentSuccess": 0,
                "sentPending": 0,
                "sentReplacement": 0,
                "refund": 0,
                "registeredFailed": 0,
                "registeredSuccess": 0
            },
            "countForCharge": {
                "sms": {},
                "lms": {},
                "mms": {},
                "ata": {},
                "cta": {},
                "cti": {},
                "nsa": {},
                "rcs_sms": {},
                "rcs_lms": {},
                "rcs_mms": {},
                "rcs_tpl": {}
            },
            "balance": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "point": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "app": {
                "profit": {
                    "sms": 0,
                    "lms": 0,
                    "mms": 0,
                    "ata": 0,
                    "cta": 0,
                    "cti": 0,
                    "nsa": 0,
                    "rcs_sms": 0,
                    "rcs_lms": 0,
                    "rcs_mms": 0,
                    "rcs_tpl": 0
                },
                "appId": "TESTAPPID",
                "version": null
            },
            "serviceMethod": "MT",
            "sdkVersion": "1.0",
            "osPlatform": "win",
            "log": [
                {
                    "createAt": "2021-07-14T07:12:42.339Z",
                    "message": "[::ffff:127.0.0.1] 메시지 그룹이 생성되었습니다."
                }
            ],
            "status": "PENDING",
            "dateSent": null,
            "scheduledDate": null,
            "dateCompleted": null,
            "isRefunded": false,
            "flagUpdated": false,
            "prepaid": true,
            "strict": false,
            "masterAccountId": null,
            "allowDuplicates": false,
            "accountId": "12925149",
            "apiVersion": "4",
            "customFields": {},
            "hint": null,
            "groupId": "G4V20210714161242KALYJKJ9VLVMJKR",
            "price": {},
            "dateCreated": "2021-07-14T07:12:42.343Z",
            "dateUpdated": "2021-07-14T07:12:42.343Z"
        },
        "G4V20210714161242FUUWHPCQA0E87S1": {
            "_id": "G4V20210714161242FUUWHPCQA0E87S1",
            "count": {
                "total": 0,
                "sentTotal": 0,
                "sentFailed": 0,
                "sentSuccess": 0,
                "sentPending": 0,
                "sentReplacement": 0,
                "refund": 0,
                "registeredFailed": 0,
                "registeredSuccess": 0
            },
            "countForCharge": {
                "sms": {},
                "lms": {},
                "mms": {},
                "ata": {},
                "cta": {},
                "cti": {},
                "nsa": {},
                "rcs_sms": {},
                "rcs_lms": {},
                "rcs_mms": {},
                "rcs_tpl": {}
            },
            "balance": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "point": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "app": {
                "profit": {
                    "sms": 0,
                    "lms": 0,
                    "mms": 0,
                    "ata": 0,
                    "cta": 0,
                    "cti": 0,
                    "nsa": 0,
                    "rcs_sms": 0,
                    "rcs_lms": 0,
                    "rcs_mms": 0,
                    "rcs_tpl": 0
                },
                "appId": null,
                "version": null
            },
            "serviceMethod": "MT",
            "sdkVersion": null,
            "osPlatform": null,
            "log": [
                {
                    "message": "유효하지 않은 AppId",
                    "createAt": "2021-07-14T07:12:42.298Z"
                }
            ],
            "status": "FAILED",
            "dateSent": null,
            "scheduledDate": null,
            "dateCompleted": null,
            "isRefunded": false,
            "flagUpdated": false,
            "prepaid": true,
            "strict": false,
            "masterAccountId": null,
            "allowDuplicates": false,
            "accountId": "12925149",
            "apiVersion": "4",
            "groupId": "G4V20210714161242FUUWHPCQA0E87S1",
            "price": {},
            "customFields": {},
            "hint": {},
            "dateCreated": "2021-07-14T07:12:42.302Z",
            "dateUpdated": "2021-07-14T07:12:42.302Z"
        },
        "G4V20210714161242FCWZDC4SR5ITUIN": {
            "_id": "G4V20210714161242FCWZDC4SR5ITUIN",
            "count": {
                "total": 0,
                "sentTotal": 0,
                "sentFailed": 0,
                "sentSuccess": 0,
                "sentPending": 0,
                "sentReplacement": 0,
                "refund": 0,
                "registeredFailed": 0,
                "registeredSuccess": 0
            },
            "countForCharge": {
                "sms": {},
                "lms": {},
                "mms": {},
                "ata": {},
                "cta": {},
                "cti": {},
                "nsa": {},
                "rcs_sms": {},
                "rcs_lms": {},
                "rcs_mms": {},
                "rcs_tpl": {}
            },
            "balance": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "point": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "app": {
                "profit": {
                    "sms": 0,
                    "lms": 0,
                    "mms": 0,
                    "ata": 0,
                    "cta": 0,
                    "cti": 0,
                    "nsa": 0,
                    "rcs_sms": 0,
                    "rcs_lms": 0,
                    "rcs_mms": 0,
                    "rcs_tpl": 0
                },
                "appId": null,
                "version": null
            },
            "serviceMethod": "MT",
            "sdkVersion": "1.0",
            "osPlatform": "win",
            "log": [
                {
                    "createAt": "2021-07-14T07:12:42.364Z",
                    "message": "[::ffff:127.0.0.1] 메시지 그룹이 생성되었습니다."
                }
            ],
            "status": "PENDING",
            "dateSent": null,
            "scheduledDate": null,
            "dateCompleted": null,
            "isRefunded": false,
            "flagUpdated": false,
            "prepaid": true,
            "strict": false,
            "masterAccountId": null,
            "allowDuplicates": false,
            "accountId": "12925149",
            "apiVersion": "4",
            "customFields": {},
            "hint": {
                "routeType": "large"
            },
            "groupId": "G4V20210714161242FCWZDC4SR5ITUIN",
            "price": {},
            "dateCreated": "2021-07-14T07:12:42.367Z",
            "dateUpdated": "2021-07-14T07:12:42.367Z"
        },
        "G4V202107141612423OCDPVBPXMAKBKT": {
            "_id": "G4V202107141612423OCDPVBPXMAKBKT",
            "count": {
                "total": 0,
                "sentTotal": 0,
                "sentFailed": 0,
                "sentSuccess": 0,
                "sentPending": 0,
                "sentReplacement": 0,
                "refund": 0,
                "registeredFailed": 0,
                "registeredSuccess": 0
            },
            "countForCharge": {
                "sms": {},
                "lms": {},
                "mms": {},
                "ata": {},
                "cta": {},
                "cti": {},
                "nsa": {},
                "rcs_sms": {},
                "rcs_lms": {},
                "rcs_mms": {},
                "rcs_tpl": {}
            },
            "balance": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "point": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "app": {
                "profit": {
                    "sms": 0,
                    "lms": 0,
                    "mms": 0,
                    "ata": 0,
                    "cta": 0,
                    "cti": 0,
                    "nsa": 0,
                    "rcs_sms": 0,
                    "rcs_lms": 0,
                    "rcs_mms": 0,
                    "rcs_tpl": 0
                },
                "appId": null,
                "version": null
            },
            "serviceMethod": "MT",
            "sdkVersion": "1.0",
            "osPlatform": "win",
            "log": [
                {
                    "createAt": "2021-07-14T07:12:42.353Z",
                    "message": "[::ffff:127.0.0.1] 메시지 그룹이 생성되었습니다."
                }
            ],
            "status": "PENDING",
            "dateSent": null,
            "scheduledDate": null,
            "dateCompleted": null,
            "isRefunded": false,
            "flagUpdated": false,
            "prepaid": true,
            "strict": false,
            "masterAccountId": null,
            "allowDuplicates": false,
            "accountId": "12925149",
            "apiVersion": "4",
            "customFields": {},
            "hint": null,
            "groupId": "G4V202107141612423OCDPVBPXMAKBKT",
            "price": {},
            "dateCreated": "2021-07-14T07:12:42.355Z",
            "dateUpdated": "2021-07-14T07:12:42.355Z"
        },
        "G4V20190FFFFFFFFFH3PTASXMNJG2JIO": {
            "_id": "G4V20190FFFFFFFFFH3PTASXMNJG2JIO",
            "count": {
                "total": 0,
                "sentTotal": 0,
                "sentFailed": 0,
                "sentSuccess": 0,
                "sentPending": 0,
                "sentReplacement": 0,
                "refund": 0,
                "registeredFailed": 0,
                "registeredSuccess": 1
            },
            "balance": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "point": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "app": {
                "profit": {
                    "sms": 0,
                    "lms": 0,
                    "mms": 0,
                    "ata": 0,
                    "cta": 0,
                    "cti": 0,
                    "nsa": 0,
                    "rcs_sms": 0,
                    "rcs_lms": 0,
                    "rcs_mms": 0,
                    "rcs_tpl": 0
                },
                "appId": null,
                "version": null
            },
            "serviceMethod": "MT",
            "sdkVersion": null,
            "osPlatform": null,
            "log": [
                {
                    "message": "메시지 그룹이 생성되었습니다.",
                    "createAt": "2021-07-14T07:12:41.958Z"
                },
                {
                    "message": "국가코드(82)의 단문문자(SMS) 1 건이 추가되었습니다.",
                    "createAt": "2021-07-14T07:12:41.958Z"
                }
            ],
            "status": "PENDING",
            "dateSent": null,
            "scheduledDate": null,
            "dateCompleted": null,
            "isRefunded": false,
            "flagUpdated": false,
            "prepaid": true,
            "strict": true,
            "masterAccountId": null,
            "allowDuplicates": false,
            "groupId": "G4V20190FFFFFFFFFH3PTASXMNJG2JIO",
            "accountId": "12925149",
            "apiVersion": "4",
            "countForCharge": {
                "sms": {
                    "82": 1
                },
                "lms": {},
                "mms": {},
                "ata": {},
                "cta": {},
                "cti": {},
                "nsa": {},
                "rcs_sms": {},
                "rcs_lms": {},
                "rcs_mms": {},
                "rcs_tpl": {}
            },
            "price": {},
            "customFields": {},
            "hint": {},
            "dateCreated": "2021-07-14T07:12:41.961Z",
            "dateUpdated": "2021-07-14T07:12:41.961Z"
        },
        "G4V20190607105937H3PTASXMNJG2JID": {
            "_id": "G4V20190607105937H3PTASXMNJG2JID",
            "count": {
                "total": 0,
                "sentTotal": 0,
                "sentFailed": 0,
                "sentSuccess": 0,
                "sentPending": 0,
                "sentReplacement": 0,
                "refund": 0,
                "registeredFailed": 0,
                "registeredSuccess": 0
            },
            "balance": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "point": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "app": {
                "profit": {
                    "sms": 0,
                    "lms": 0,
                    "mms": 0,
                    "ata": 0,
                    "cta": 0,
                    "cti": 0,
                    "nsa": 0,
                    "rcs_sms": 0,
                    "rcs_lms": 0,
                    "rcs_mms": 0,
                    "rcs_tpl": 0
                },
                "appId": null,
                "version": null
            },
            "serviceMethod": "MT",
            "sdkVersion": null,
            "osPlatform": null,
            "log": [
                {
                    "createAt": "2021-07-14T07:12:41.918Z",
                    "message": "메시지 그룹이 생성되었습니다."
                }
            ],
            "status": "PENDING",
            "dateSent": null,
            "scheduledDate": null,
            "dateCompleted": null,
            "isRefunded": false,
            "flagUpdated": false,
            "prepaid": true,
            "strict": true,
            "masterAccountId": null,
            "allowDuplicates": false,
            "groupId": "G4V20190607105937H3PTASXMNJG2JID",
            "accountId": "12925149",
            "apiVersion": "4",
            "countForCharge": {
                "sms": {
                    "82": 0
                },
                "lms": {},
                "mms": {},
                "ata": {},
                "cta": {},
                "cti": {},
                "nsa": {},
                "rcs_sms": {},
                "rcs_lms": {},
                "rcs_mms": {},
                "rcs_tpl": {}
            },
            "price": {},
            "customFields": {},
            "hint": {},
            "dateCreated": "2021-07-14T07:12:41.927Z",
            "dateUpdated": "2021-07-14T07:12:41.927Z"
        },
        "G4V20190607105937H3PFASXMNJG2JID": {
            "_id": "G4V20190607105937H3PFASXMNJG2JID",
            "count": {
                "total": 0,
                "sentTotal": 0,
                "sentFailed": 0,
                "sentSuccess": 0,
                "sentPending": 0,
                "sentReplacement": 0,
                "refund": 0,
                "registeredFailed": 0,
                "registeredSuccess": 0
            },
            "balance": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "point": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "app": {
                "profit": {
                    "sms": 0,
                    "lms": 0,
                    "mms": 0,
                    "ata": 0,
                    "cta": 0,
                    "cti": 0,
                    "nsa": 0,
                    "rcs_sms": 0,
                    "rcs_lms": 0,
                    "rcs_mms": 0,
                    "rcs_tpl": 0
                },
                "appId": null,
                "version": null
            },
            "serviceMethod": "MT",
            "sdkVersion": null,
            "osPlatform": null,
            "log": [
                {
                    "createAt": "2021-07-14T07:12:41.930Z",
                    "message": "메시지 그룹이 생성되었습니다."
                }
            ],
            "status": "PENDING",
            "dateSent": null,
            "scheduledDate": null,
            "dateCompleted": null,
            "isRefunded": false,
            "flagUpdated": false,
            "prepaid": true,
            "strict": true,
            "masterAccountId": null,
            "allowDuplicates": false,
            "groupId": "G4V20190607105937H3PFASXMNJG2JID",
            "accountId": "12925149",
            "apiVersion": "4",
            "countForCharge": {
                "sms": {
                    "82": 0
                },
                "lms": {},
                "mms": {},
                "ata": {},
                "cta": {},
                "cti": {},
                "nsa": {},
                "rcs_sms": {},
                "rcs_lms": {},
                "rcs_mms": {},
                "rcs_tpl": {}
            },
            "price": {},
            "customFields": {},
            "hint": {},
            "dateCreated": "2021-07-14T07:12:41.933Z",
            "dateUpdated": "2021-07-14T07:12:41.933Z"
        },
        "G4V2019030710593FFFNCELSCHEDULE4": {
            "_id": "G4V2019030710593FFFNCELSCHEDULE4",
            "count": {
                "total": 0,
                "sentTotal": 0,
                "sentFailed": 0,
                "sentSuccess": 0,
                "sentPending": 0,
                "sentReplacement": 0,
                "refund": 0,
                "registeredFailed": 0,
                "registeredSuccess": 1
            },
            "balance": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "point": {
                "requested": 0,
                "replacement": 0,
                "refund": 0,
                "sum": 0
            },
            "app": {
                "profit": {
                    "sms": 0,
                    "lms": 0,
                    "mms": 0,
                    "ata": 0,
                    "cta": 0,
                    "cti": 0,
                    "nsa": 0,
                    "rcs_sms": 0,
                    "rcs_lms": 0,
                    "rcs_mms": 0,
                    "rcs_tpl": 0
                },
                "appId": null,
                "version": null
            },
            "serviceMethod": "MT",
            "sdkVersion": null,
            "osPlatform": null,
            "log": [
                {
                    "message": "메시지 그룹이 생성되었습니다.",
                    "createAt": "2021-07-14T07:12:41.940Z"
                },
                {
                    "message": "국가코드(82)의 단문문자(SMS) 1 건이 추가되었습니다.",
                    "createAt": "2021-07-14T07:12:41.940Z"
                }
            ],
            "status": "FAILED",
            "dateSent": null,
            "scheduledDate": null,
            "dateCompleted": null,
            "isRefunded": false,
            "flagUpdated": false,
            "prepaid": true,
            "strict": true,
            "masterAccountId": null,
            "allowDuplicates": false,
            "groupId": "G4V2019030710593FFFNCELSCHEDULE4",
            "accountId": "12925149",
            "apiVersion": "4",
            "countForCharge": {
                "sms": {
                    "82": 1
                },
                "lms": {},
                "mms": {},
                "ata": {},
                "cta": {},
                "cti": {},
                "nsa": {},
                "rcs_sms": {},
                "rcs_lms": {},
                "rcs_mms": {},
                "rcs_tpl": {}
            },
            "price": {},
            "customFields": {},
            "hint": {},
            "dateCreated": "2021-07-14T07:12:41.943Z",
            "dateUpdated": "2021-07-14T07:12:41.943Z"
        }
    },
    "nextKey": "G4V20190307105937H3PTASXMNJGCCCC"
}

Sample Code

var request = require('request');

var options = {
  headers: {
    Authorization:
      'HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4'
  },
  method: 'GET',
  json: true,
  url: 'http://api.coolsms.co.kr/messages/v4/groups?limit=10'
};

request(options, function(error, response, body) {
  if (error) throw error;
  console.log('result :', body);
});
<?php
$url = "http://api.coolsms.co.kr/messages/v4/groups?limit=10";

$options = array(
    'http' => array(
        'header'  => "Authorization: HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4\r\n",
        'method'  => 'GET'
    )
);

$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);

var_dump($result);
import requests

url = "http://api.coolsms.co.kr/messages/v4/groups?limit=10"
headers = {
  "Authorization": "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4"
}

response = requests.get(url, headers=headers)
print(response.status_code)
print(response.text)
#!/bin/bash
curl -X GET \
    -H 'Authorization: HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4' \
    http://api.coolsms.co.kr/messages/v4/groups?limit=10
require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("http://api.coolsms.co.kr/messages/v4/groups?limit=10")

headers = {
  "Authorization": "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4"
}
http = Net::HTTP.new(uri.host, uri.port)
request = Net::HTTP::Get.new(uri.request_uri, headers)

response = http.request(request)
puts response.code
puts response.body
package main

import (
  "fmt"
  "io/ioutil"
  "net/http"
  "strings"
)

func main() {
  uri := "http://api.coolsms.co.kr/messages/v4/groups?limit=10"

  req, err := http.NewRequest("GET", uri, nil)
  if err != nil { panic(err) }

  req.Header.Set("Authorization", "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4")

  client := &http.Client{}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()

  bytes, _ := ioutil.ReadAll(resp.Body)
  str := string(bytes)
  fmt.Println(str)
}
package solapi;

import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class Request {
  public static void main(String[] args) throws Exception {
    String targetUrl = "http://api.coolsms.co.kr/messages/v4/groups?limit=10";

    URL url = new URL(targetUrl);
    HttpURLConnection con = (HttpURLConnection) url.openConnection();

    con.setRequestMethod("GET");

    con.setRequestProperty("Authorization", "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4");

    con.setDoOutput(true);
    DataOutputStream wr = new DataOutputStream(con.getOutputStream());
    wr.writeBytes(parameters);
    wr.flush();
    wr.close();

    int responseCode = con.getResponseCode();
    BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
    String line;
    StringBuffer response = new StringBuffer();
    while ((line = in.readLine()) != null) {
      response.append(line);
    }
    in.close();

    System.out.println("HTTP response code : " + responseCode);
    System.out.println("HTTP body : " + response.toString());
  }
}

문서 생성일 : 2021-07-14

Allowed Operator

[?]
[?]
groupList
groupId
count
balance
point
app
log
countForCharge
price
profit
sms
lms
mms
ata
cta
cti
nsa
rcs_sms
rcs_lms
rcs_mms
rcs_tpl