그룹 메시지 발송

1
Last updated 3 months ago

post
그룹 메시지 발송

https://rest.coolsms.co.kr
/messages/v4/groups/:groupId/send
그룹에 담겨져 있는 메시지 발송 요청합니다.
Request
Response
Path Parameters
groupId
required
string
이미 만들어진 그룹의 아이디
Headers
Authorization
required
string
인증 정보
200: OK
발송 요청이 성공한 경우
{
_id: 'G4V20181019142110RCZZBOHIUJD4OUE',
count: {
total: 3,
sentTotal: 0,
sentFailed: 0,
sentSuccess: 0,
sentPending: 0,
sentReplacement: 0,
refund: 0,
registeredFailed: 2,
registeredSuccess: 1
},
countForCharge: {
sms: {'82': 1},
lms: {},
mms: {},
ata: {},
cta: {}
},
balance: {
requested: 0,
replacement: 0,
refund: 0,
sum: 0
},
point: {
requested: 20,
replacement: 0,
refund: 0,
sum: 0
},
app: {
profit: {
sms: 0,
lms: 0,
mms: 0,
ata: 0,
cta: 0
},
appId: None,
version: None
},
sdkVersion: None,
osPlatform: None,
log: [
{
message: '메시지 그룹이 생성되었습니다.',
createAt: '2018-10-19T05:21:10.192Z'
},
{
createAt: '2018-10-19T05:22:53.156Z',
message: '국가코드(82)의 단문문자(SMS) 1 건이 추가되었습니다.'
},
{
createAt: '2018-10-19T05:25:06.930Z',
message: '메시지를 발송했습니다.',
oldBalance: 0,
newBalance: 0,
oldPoint: 21312241,
newPoint: 21312221,
totalPrice: 20
}
],
status: 'SENDING',
scheduledDate: None,
dateSent: '2018-10-19T05:25:06.930Z',
dateCompleted: None,
isRefunded: False,
flagUpdated: False,
accountId: '12062181',
apiVersion: '4',
groupId: 'G4V20181019142110RCZZBOHIUJD4OUE',
price: {
'82': {
sms: 20,
lms: 50,
mms: 200,
ata: 19,
cta: 13,
dateCreated: '2018-10-18T23:59:22.967Z',
dateUpdated: '2018-10-18T23:59:22.967Z'
}
},
dateCreated: '2018-10-19T05:21:10.205Z',
dateUpdated: '2018-10-19T05:25:06.931Z'
}
400: Bad Request
서버에서 거절하는 경우
{
"errorCode": "DeletedGroup",
"errorMessage": "삭제 처리된 그룹으로는 발송이 안됩니다."
}
{
"errorCode": "ValidationError",
"errorMessage": "groupId 의 형식이 잘못 된 경우"
}
{
"errorCode": "FailedGroup",
"errorMessage": "그룹 생성에 실패했던 그룹입니다.\n그룹 로그를 확인해주세요."
}
{
"errorCode": "InactiveApp",
"errorMessage": "현재 사용하시는 앱의 상태가 비활성화 상태입니다."
}
{
"errorCode": "InvalidStatus",
"errorMessage": "'PENDING' 상태의 그룹만 전송 가능합니다."
}
402: Payment Required
발송을 위한 보유 액이 부족한 경우
{
"errorCode": "NotEnoughBalance",
"errorMessage": "현재보유 잔액이 부족합니다."
}
404: Not Found
자신이 보유한 그룹이 아닌 경우
{
"errorCode": "ResourceNotFound",
"errorMessage": "해당 그룹아이디가 존재하지 않습니다."
}
409: Conflict
이미 발송 요청한 그룹인 경우
{
"errorCode": "GroupInProcessing",
"errorMessage": "이미 발송 요청된 그룹입니다."
}
{
"errorCode": "ScheduledGroup",
"errorMessage": "발송 예약된 그룹이므로 발송이 불가능합니다."
}
{
"errorCode": "AlreadySent",
"errorMessage": "이미 발송이 완료된 그룹입니다."
}

예제 코드

[JavaScript] send_group_message.js

[Python] send_group_message.py

[Java] send_group_message.java

[PHP] send_group_message.php

[Ruby] send_group_message.rb