简体中文
简体中文
English
联系我们
注册
登录
语言
简体中文
简体中文
English
联系我们
登录
注册
返回主站
layout空间导航

请求结构

更新时间:2021-09-23 09:24:45下载pdf

本文为您介绍云开发 API 请求中的请求方法、接入地址和请求头参数。

请求方法

云开发平台 API 支持以下请求方法。

方法 说明
GET 请求服务器返回指定资源
PUT 请求服务器更新指定资源
POST 请求服务器执行特定操作
DELETE 请求服务器指定删除资源

说明:当请求方法为 POST 时,Content-Type 参数值为 application/json

接入地址

云开发平台为不同的区域提供不同的接入地址,请根据设备所在区域选择接入地址,缩短调试响应时长。

地域 地址
中国数据中心 https://openapi.tuyacn.com
美西数据中心 https://openapi.tuyaus.com
美东数据中心 https://openapi-ueaz.tuyaus.com
中欧数据中心 https://openapi.tuyaeu.com
西欧数据中心 https://openapi-weaz.tuyaeu.com
印度数据中心 https://openapi.tuyain.com

请求头参数

以下是调用云开发平台接口时的常用请求头(Request header) 参数,请务必在请求头中加入必填的参数。

参数名 类型 参数位置 必填 说明
client_id
String
header 用户 ID。
sign String header 采用指定签名算法计算出的签名。
sign_method String header 签名的摘要算法,固定为 HMAC-SHA256。
t Long header 13 位标准时间戳。
access_token String header token 信息。
说明:获取和刷新 Token 接口不需要此参数。
lang String header 语言类型。中国区默认 zh,其他区默认 en
nonce String header API调用者生成的UUID。
说明:旧版签名方案无需该参数。
Signature-Headers String header 开发者自定义需要加入签名的header字段。
说明:旧版签名方案无需该参数。

请求示例

获取用户列表 API 为例:按照 50 条分页,获取 从 2021-05-01 00:00:00 到 2021-05-15 00:00:00 ,第 1 页的用户列表信息的请求如下:

  • API 请求
    GET:https://openapi.tuyacn.com/v2.0/apps/schema/users?page_no=1&page_size=50&start_time=1619798400&end_time=1621008000
    
  • 请求头
    client_id: 1KAD46OrT9HafiKd****
    sign: C5EFD19AD45E33A060C0BE47AEF65D975D54B2D70CBAA7A1ACA1A7D0E5C0****
    sign_method: HMAC-SHA256
    t: 1588925778000
    access_token: 3f4eda2bdec17232f67c0b188af3****
    nonce: 5138cc3a9033d69856923fd07b49****
    Signature-Headers: area_id:request_id
    area_id: 29a33e8796834b1**** // 用户自定义
    request_id: 8afdb70ab2ed11eb85290242ac13****// 用户自定义