① 上传云数据时附带获取配置(推荐)
上传数据时附带 token 和 client_ts,若 token 有效且配置有更新则一并返回,节省一次请求。token 无效时上传仍正常完成,仅不返回配置数据。
请求参数
| 参数 | 类型 | 必填 | 说明 |
| token | string | 可选 | 小程序配置码,不传则不返回配置 |
| client_ts | int | 可选 | 本地上次获取配置的时间戳,不传则强制返回配置 |
返回字段
| 字段 | 类型 | 说明 |
| success | bool | 上传是否成功(始终为 true,不因 token 失败) |
| token_valid | bool | token 是否有效(不传 token 时此字段不存在) |
| config_changed | bool | 配置是否有更新(仅 token_valid=true 时存在) |
| config | object | 配置内容(仅 config_changed=true 时存在) |
| config.ts | int | 配置更新时间戳,保存到本地作为下次的 client_ts |
POST https://farm.yamm.top/api/upload
{ "username":"林小农", "zoneCode":"1区", "token":"ABCD-1234", "client_ts":1750000000 }
// 有更新:{ "success":true, "token_valid":true, "config_changed":true, "config":{"ts":1750001234,...} }
// 无更新:{ "success":true, "token_valid":true, "config_changed":false }
// token 无效:{ "success":true, "token_valid":false }(脚本应提示用户重新获取配置码)
② 单独获取配置
脚本启动时或需要主动同步配置时调用。传 client_ts 可实现增量更新,避免重复下载未变化的配置。token 不存在时返回 success=false,脚本应提示用户重新获取配置码。
请求参数
| 参数 | 类型 | 必填 | 说明 |
| token | string | 必填 | 小程序配置码,格式 XXXX-XXXX |
| client_ts | int | 可选 | 本地配置时间戳,不传则始终返回配置内容 |
返回字段
| 字段 | 类型 | 说明 |
| success | bool | true=token 有效,false=token 无效或不存在 |
| message | string | 错误原因(仅 success=false 时存在) |
| changed | bool | 配置是否有更新(仅 success=true 时存在) |
| config | object | 配置内容(仅 changed=true 时存在) |
| config.ts | int | 配置更新时间戳,保存后作为下次请求的 client_ts |
GET https://farm.yamm.top/api/config?token=ABCD-1234&client_ts=1750000000
// 有更新:{ "success":true, "changed":true, "config":{"ts":1750001234,"interval":30,...} }
// 无更新:{ "success":true, "changed":false }
// token 无效:{ "success":false, "message":"无效的配置码" }