查询套餐列表 - 探鸽开放平台API文档

请求参数

Query 参数

product_id

string

套餐产品ID

可选

示例值:

10001

product_type

string

可选

套餐产品类型（standard：普通套餐即用户侧订购的套餐，customer：开发者侧订购的套餐，比如续费设备ID授权）

示例值:

standard

country_code

string

国家代码

可选

示例值:

CN

device_id

string

查询设备可购买套餐

可选

示例值:

1702D8OBYWWQ

Header 参数

X-Tg-Signed-Headers

string

必需

参与预算签名的header

示例值:

x-tg-app-id;x-tg-date

X-Tg-App-Id

string

必需

开发者帐号的APPID

默认值:

Accept-Language

string

必需

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

默认值:

Authorization

string

必需

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

默认值:

X-Tg-Date

string

必需

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

默认值:

20060102T150405Z

X-Tg-Content-Sha256

string

必需

将BODY数据进行SHA256计算后的值

X-Tg-Algorithm

string

必需

目前服务端接口使用的签名算法的版本号和哈希算法

默认值:

TGV1-HMAC-SHA256

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://openapi-cn01.tange365.com/v2/cloud-service/plans?product_id=10001&product_type=standard&country_code=CN&device_id=1702D8OBYWWQ' \
--header 'X-Tg-Signed-Headers: x-tg-app-id;x-tg-date' \
--header 'X-Tg-Signed-Headers;' \
--header 'X-Tg-App-Id;' \
--header 'Accept-Language;' \
--header 'Authorization;' \
--header 'X-Tg-Date;' \
--header 'X-Tg-Content-Sha256;' \
--header 'X-Tg-Algorithm;'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

非200表示出错

msg

string

错误描述

必需

data

object

必需

items

array [object {13}]

必需

示例

{
  "code": 200,
  "msg": "ok",
  "data": {
    "items": [
      {
        "service_id": 70,
        "product_id": 70,
        "product_type": "standard",
        "name": "包看专业版",
        "price": 62,
        "fee_amount": 43,
        "currency_code": "￥",
        "country_code": "CN",
        "ability": {
          "traffic": {
            "traffic_limit": 500,
            "limit_mode": "month"
          },
          "storage": {
            "recording_mode": "INCIDENT",
            "recording_content": [
              "IMAGE"
            ],
            "recording_ahead": 5,
            "recording_duration": 30,
            "recording_image_max": 5,
            "recording_image_span": 3,
            "save_days": 30
          },
          "ai": {
            "algorithm": [
              "body",
              "pet"
            ]
          },
          "smart_box": {
            "supported_smart_box": [
              "echo-show"
            ]
          }
        },
        "level": 2,
        "version_name": "一个月",
        "period": 30,
        "ext_attrs": ""
      }
    ]
  }
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误