手动存档

POST

/jyapi/manualSave

1、在游戏过程中，用户可以主动发起存档，接口负责获取手动存档授权save_config，然后客户端调用sdk(uploadSave方法)手动存档函数，实现存档保存

2、保存的存档，可以通过存档列表接口获取；

3、存档完成回调，依据参数notify_url回调

地址：$notify_url
请求方式：post
数据：{
    "save_time":"forever123"  //存档名称，以save_time作为命名
}

请求参数

Body 参数application/json

channel_id

string

渠道id

必需

string

设备号

必需

每个设备对应一个sn唯一码

client_sid

string

用户标识

必需

string

客户端IP

必需

time

integer

时间戳

必需

sign

string

签名

必需

sc_id

integer

会话id

必需

notify_url

string

存档完成回调地址

可选

示例

{
    "channel_id": "a486828e0524c7f10f4ad56785b64b93",
    "sn": "bea6becab50afccac8db6f5318008dcf",
    "client_sid": "testKey",
    "ip": "36.238.203.74",
    "time": 1731464631,
    "sign": "23C0B59972393FC6382B7BF9D2A701FE",
    "sc_id": 1,
    "notify_url": ""
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/jyapi/manualSave' \
--header 'Content-Type: application/json' \
--data-raw '{
    "channel_id": "a486828e0524c7f10f4ad56785b64b93",
    "sn": "bea6becab50afccac8db6f5318008dcf",
    "client_sid": "testKey",
    "ip": "36.238.203.74",
    "time": 1731464631,
    "sign": "23C0B59972393FC6382B7BF9D2A701FE",
    "sc_id": 1,
    "notify_url": ""
}'

返回响应

🟢200成功

application/json

Body

status

integer

状态码

必需

200、成功其他为错误

msg

string

消息

必需

data

object

数据

必需

save_config

string

存档授权

必需

示例

{
    "status": 200,
    "msg": "success",
    "data": {
        "save_config": "KNWCzfRHbMYLPGEEg+/OXZifpMmzoHB43Qx3PU07u+Q2Z7K/gnd7VV6vVVUKuNACD/Bpm0JDcYXTgMWyo0dnINm6vdgSuiDfA+U3IDq9ZwkvS/M/e8zcVoQaRmFzDQUhI5pYtFCQ6ZCZww6he9K2Zt5au+ybldCu9uzGxMh5GoHg3n8hFefbqJ8hqMgrCStaXwg1eeF0ESqyxFuHpnoI/Q=="
    }
}

修改于 2025-06-16 06:06:46

客户端主动挂机

游戏存档指定用户