https://hjapi.hjykj.top/api/piaoliuping/api.php
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
apikey
必填
|
string | 是 | 你开通的apikey | - |
action
必填
|
string | 是 | 操作类型:throw(扔瓶子)、pick(捡瓶子)、reply(回复瓶子) | - |
nickname
|
string | 否 | 昵称(默认"匿名") | - |
content
|
string | 否 | 瓶子内容(扔瓶子时必填,最长500字符) | - |
bottle_id string
|
string | 否 | 瓶子ID(回复瓶子时必填) | - |
reply_content
|
string | 否 | 回复内容(回复瓶子时必填) | - |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
code
|
int | 状态码:200成功,0失败 | - |
msg
|
string | 提示信息 | - |
data
|
Array | 返回数据 | - |
data.bottle_id
|
string | 瓶子唯一ID(扔瓶子时返回) | - |
data.content
|
string | 瓶子内容(捡瓶子时返回) | - |
data.nickname
|
string | 发送者昵称 | - |
data.time
|
string | 发送时间 | - |
data.replies
|
Array | 回复列表 | - |
data.remaining
|
int | 今日剩余可捡瓶子数 | - |
curl -X GET "https://hjapi.hjykj.top/api/piaoliuping/api.php"
-d "apikey=value"
-d "action=value"
丢瓶子
{
"code": 200,
"msg": "瓶子已扔入大海",
"data": {
"bottle_id": "bottle_5f7a8b3c9d2e1_8a7b6c5d4e3f2a1b",
"content": "今天天气真好,希望有人能捡到这个瓶子",
"nickname": "阳光旅人",
"time": "2026-04-19 14:35:22"
}
捡瓶子
{
"code": 200,
"msg": "捞到一个漂流瓶",
"data": {
"bottle_id": "bottle_5f7a8b3c9d2e1_8a7b6c5d4e3f2a1b",
"content": "今天天气真好,希望有人能捡到这个瓶子",
"nickname": "阳光旅人",
"time": "2026-04-19 14:35:22",
"replies": [
{
"nickname": "海边拾贝",
"content": "我这边下雨了,羡慕好天气!",
"time": "2026-04-19 15:20:10"
},
{
"nickname": "云朵",
"content": "加油,生活总会越来越好的",
"time": "2026-04-19 16:05:33"
}
],
"remaining": 8
}
}
回复瓶子
{
"code": 200,
"msg": "回复成功",
"data": {
"bottle_id": "bottle_5f7a8b3c9d2e1_8a7b6c5d4e3f2a1b",
"reply": {
"nickname": "路过的人",
"content": "我也很喜欢这样的天气,祝你开心!",
"time": "2026-04-19 17:30:45"
}
}
}
以下是通用错误代码说明:
| 状态码 | 状态 | 说明 | 解决方案 |
|---|---|---|---|
| 0 | 成功 | 请求成功,返回所需数据 | 正常处理返回数据 |
| -1 | 缺少API秘钥 | API密钥不能为空! | 检查请求参数是否符合要求 |
| -1 | 秘钥无效 | API密钥不存在或无效! | 检查API密钥是否正确 |
| -1 | 账号已被封禁 | 账号已被禁止使用 | 检查账户权限 |
| -1 | 接口不存在/接口已下架 | 请求的接口地址不存在 | 检查接口地址是否正确 |
| -1 | 当前接口需要实名认证才可以使用 | 登录网站进行实名认证 | 有些接口需要实名 |
| -1 | 余额不足 | 账户余额不足无法调用按此计费接口 | 请及时充值余额 |
| -1 | 请先开通包月服务 | 按月付费接口 | 请开通包月使用 |
| -1 | 会员已到期 | 按月接口到期 | 请续费包月使用 |
| -1 | 当前用户无权限调用 | VIP会员专用接口 | 请开通对应的会员进行使用 |