그룹 메시지 예약 접수

2
Last updated 3 months ago

post
scheduleGroupMessage

https://rest.coolsms.co.kr
/messages/v4/groups/:groupId/schedule
그룹 메시지를 예약 접수 합니다. 최대 6개월까지 접수 가능하며 발송시잔액이 차감되니 주의 부탁드립니다. (발송 시점에 잔액이 없을 경우 발송 실패)
Request
Response
Path Parameters
groupId
required
string
그룹 아이디
Headers
Authorization
required
string
쿨에스엠에스 인증 정보
Body Parameters
scheduledDate
required
string
ISO 8601 형식의 발송될 시각
200: OK
{
_id: 'G4V20181019090749JPZH8HEYXURHFQ6',
count: {
total: 1,
sentTotal: 0,
sentFailed: 0,
sentSuccess: 0,
sentPending: 0,
sentReplacement: 0,
refund: 0,
registeredFailed: 0,
registeredSuccess: 1
},
countForCharge: {
sms: {'82': 1},
lms: {},
mms: {},
ata: {},
cta: {}
},
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
},
appId: None,
version: None
},
sdkVersion: None,
osPlatform: None,
log: [
{
message: '메시지 그룹이 생성되었습니다.',
createAt: '2018-10-19T00:07:49.822Z'
},
{
createAt: '2018-10-19T00:08:02.671Z',
message: '국가코드(82)의 단문문자(SMS) 1 건이 추가되었습니다.'
},
{
createAt: '2018-10-19T00:09:12.062Z',
message: '메시지 예약이 성공적으로 접수됐습니다.',
messageCount: {
total: 1,
sentTotal: 0,
sentFailed: 0,
sentSuccess: 0,
sentPending: 0,
sentReplacement: 0,
refund: 0,
registeredFailed: 0,
registeredSuccess: 1
}
}
],
status: 'PENDING',
scheduledDate: None,
dateSent: None,
dateCompleted: None,
isRefunded: False,
flagUpdated: False,
accountId: '12062181',
apiVersion: '4',
groupId: 'G4V20181019090749JPZH8HEYXURHFQ6',
price: {},
dateCreated: '2018-10-19T00:07:49.835Z',
dateUpdated: '2018-10-19T00:14:20.301Z'
}
400: Bad Request
{
errorCode: "BlockedApp",
errorMessage: "차단 처리된 앱으로 사용이 불가능합니다."
}
{
errorCode: "InDevelopment",
errorMessage: "개발단계의 앱으로 아직 출시되지 않았습니다."
}
{
errorCode: "InvalidScheduledDate",
errorMessage: "예약시간은 현재시간보다 늦게 설정 가능합니다."
}
{
errorCode: "InvalidScheduledDate",
errorMessage: "발송 예정일이 6개월을 초과하여 발송 예약에 실패하였습니다."
}
404: Not Found
{
errorCode: "ResourceNotFound",
errorMessage: "해당 그룹아이디가 존재하지 않습니다."
}

예제 코드

[JavaScript] add_scheduledDate.js

[Python] add_scheduledDate.py

[Java] add_scheduledDate.java

[PHP] add_scheduledDate.php

[Ruby] add_scheduledDate.rb