查询已购买服务 - 探鸽开放平台API文档

请求参数

Query 参数

status

integer

可选

有效期状态：0查全部、1查已过期、2查生效中、3查待生效、4查有效的(包含生效中、待生效)

示例值:

product_id

integer

可选

套餐产品ID，0或不传返回全部

示例值:

device_id

string

设备ID

必需

示例值:

693LYWBZFDUS

Header 参数

X-Tg-App-Id

string

必需

开发者帐号的APPID

默认值:

X-Tg-Platform

string

必需

请求来源：android/ios/pc/web/device

默认值:

示例值:

androidiOSwebdevicepc

X-Tg-Sdk-Version

string

必需

API SDK版本号：1024

默认值:

Accept-Language

string

必需

请求端的本地语言（zh-cn, zh-tw, en-us, ja, ko, vi, es, pt, ru, tr, de, it, fr, pl, th, ar）

默认值:

示例值:

zh-cnzh-twen-usjakoviesptrutrdeitfrplthar

X-Tg-App-Store

string

手机APP应用商店

可选

默认值:

X-Tg-App-Pkgname

string

手机APP包名

必需

默认值:

Authorization

string

必需

服务端接口时传入签名计算后的字符串。客户端APP传入用户登陆态数据access_token。两者不要混用。

默认值:

X-Tg-Date

string

必需

当前请求的UTC+0时间（注意时区，不是本地时区）

默认值:

20060102T150405Z

X-Tg-App-Version

string

APP版本号

可选

默认值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

非200表示出错

msg

string

错误描述

必需

data

object

必需

items

array [object {15}]

设备的服务

必需

total

integer

设备的服务数量

必需

示例

{
    "code": 200,
    "msg": "ok",
    "data": {
        "items": [
            {
                "id": 70,
                "order_id": 1682666553,
                "device_id": "1702D8OBYWWQ",
                "iccid": "89861122241045896497",
                "product_id": 70,
                "service_id": 70,
                "ability": {
                    "storage": {
                        "recording_mode": "INCIDENT",
                        "recording_content": [
                            "IMAGE"
                        ],
                        "recording_ahead": 5,
                        "recording_duration": 30,
                        "recording_image_max": 5,
                        "recording_image_span": 3,
                        "keep_days": 30
                    },
                    "ai": {
                        "algorithm": [
                            "body",
                            "pet"
                        ]
                    },
                    "mobile_data": {
                        "traffic_limit": 500,
                        "limit_mode": "month"
                    },
                    "smart_box": {
                        "supported_smart_box": [
                            "echo-show"
                        ]
                    }
                },
                "level": 2,
                "is_free": 0,
                "contract_status": 0,
                "status": 0,
                "frozen_time": 1682666553,
                "start_time": 1682666553,
                "end_time": 1682666553,
                "duration_status": 0
            }
        ],
        "total": 1
    }
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误