연동가이드 >/wiki/spaces/KS4GFP/pages/533463104우편함
| 목차 |
|---|
| minLevel | 1 |
|---|
| maxLevel | 1 |
|---|
| outline | false |
|---|
| type | list |
|---|
| printable | false |
|---|
|
...
/message/send
Description
메시지 배송 서버로 다른 유저에게 메시지를 전달 요청합니다.
...
| 코드 블럭 |
|---|
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"messageId": "c21c6dfe-c13b-46ff-9946-961d28beb914"
} |
|
...
/message/getList
Description
메시지 배송 서버로 전달된 메시지 목록을 조회합니다.
...
| 코드 블럭 |
|---|
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"status": 200,
"desc": "OK",
"content": {
"nextPageKey": -1,
"messages": [
{
"appId": "103815",
"senderId": "admin",
"receiverId": "990566329112884",
"message": {
"deliverySeq": 21519071,
"messageId": "6fec1bc2-e3b2-4fd2-a31e-6c192154f61e",
"messageBoxId": "inbox",
"senderAppId": "103815",
"senderId": "admin",
"receiverAppId": "103815",
"receiverId": "990566329112884",
"title": "0802보상",
"body": "0802보상",
"titleMap": {},
"bodyMap": {},
"resourceMap": {},
"state": "unread",
"regTime": 1690939713000,
"modTime": 1690939713000,
"readTime": null,
"expiredTime": 1691544513000,
"expiryTime": 1691544513000
},
"items": [
{
"itemId": "f0d1aea9-2c9c-43fd-b227-cd315799b216",
"itemCode": "worldcon",
"itemName": "월드콘",
"quantity": 5,
"state": "registered",
"sentCount": 0,
"regTime": 1690939713000,
"modTime": 1690939713000,
"sentTime": null,
"confirmedTime": null,
"expiredTime": 1691544513000,
"expiryTime": 1691544513000,
"validityTime": 604800000
}
],
"existUnconfirmedItems": true
}
],
"totalCount": 1,
"maxCount": 1000000
}
} |
|
...
/message/claimItems
Description
메시지에 포함된 아이템들의 수령 요청을 플랫폼 서버에 알립니다.
위 API 호출시 지급할 아이템 목록을 반환하고 ‘지급중(발송처리중)’ 상태로 변경 되며 처리가 완료된 이후 /message/finish 를 호출해야 지급완료 상태가 되어 트랜잭션이 종료 됩니다.
만약 /message/finish를 호출하지 않으면 처리가 완료되지 않은 것으로 간주되어 동일한 요청이 들어오면 이전과 같은 목록을 반환합니다.
...
| 코드 블럭 |
|---|
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"results": [
{
"messageId": "6fec1bc2-e3b2-4fd2-a31e-6c192154f61e",
"status": 200,
"receiverId": "990566329112884",
"senderId": "admin",
"resourceMap": {},
"items": [
{
"appId": "103815",
"itemCode": "worldcon",
"quantity": 5,
"itemId": "f0d1aea9-2c9c-43fd-b227-cd315799b216",
"validityTime": 604800000,
"senderId": "admin"
}
]
}
]
} |
|
...
/message/finish
Description
/message/claim 이후에 게임서버에서 게임 지급이 정상적으로 처리된 후에 호출합니다.
...
| 코드 블럭 |
|---|
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"results": [
{
"messageId": "6fec1bc2-e3b2-4fd2-a31e-6c192154f61e",
"status": 200
}
]
} |
...
/message/markAsRead
Description
메시지를 읽음 처리합니다.
...
| 코드 블럭 |
|---|
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
} |
|
...
/message/confirmItems
Description
아이템 지급 완료 후 호출하여 메시지 상태를 변경합니다.
...
| 코드 블럭 |
|---|
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"results" : [
{
"messageId" : "3729694e-913b-4b29-94ef-36fd66f44ce8",
"status" : 200
},
{
"messageId" : "4234554e-783b-b4g4-3f43-nfc34987fn38",
"status" : 200
}
]
} |
|
...
/message/deleteMessages
Description
메시지 상태를 ‘삭제완료’ 상태로 변경합니다.
...