接口规范

接口规范

本文档说明 Insta360 开放平台 API 的通用约定,包括请求格式、响应格式、HTTP 状态码与业务错误码体系。

规划阶段

本页面描述的是规划中的能力,具体接口以正式发布为准。

请求格式

  • 协议: HTTPS
  • Content-Type: application/json
  • 字符编码: UTF-8
  • Base URL: https://open.insta360.com/api/v1

响应格式

所有接口返回统一的 JSON 结构:

{
  "code": 0,
  "message": "success",
  "data": {}
}
字段类型说明
codenumber业务状态码,0 表示成功
messagestring状态描述
dataobject / array响应数据

HTTP 状态码

状态码含义
200请求成功
400请求参数错误
401未认证或认证过期
403无权限访问
404资源不存在
429请求频率超限
500服务端错误

业务错误码

业务错误码通过响应体中的 code 字段返回,具体定义将在各接口文档中说明。