漂流瓶

接口状态
正常
请求方式
GET
数据格式
json
计费方式
¥免费

接口详情

接口地址

https://hjapi.hjykj.top/api/piaoliuping/api.php

接口标签

GET json 正常 免费

接口描述

请求参数

参数名 类型 必填 说明 示例
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
PHP
Python
Node.js
cURL示例

curl -X GET "https://hjapi.hjykj.top/api/piaoliuping/api.php"
  -d "apikey=value"
  -d "action=value"
                                    

响应示例

成功响应

JSON响应
丢瓶子
{
    "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会员专用接口 请开通对应的会员进行使用