API Specification

API Specification

This document describes the common conventions of the Insta360 Open Platform API, including request format, response format, HTTP status codes, and business error codes.

Planning Stage

The content on this page describes planned capabilities. Specific APIs are subject to change upon official release.

Request Format

  • Protocol: HTTPS
  • Content-Type: application/json
  • Character Encoding: UTF-8
  • Base URL: https://open.insta360.com/api/v1

Response Format

All endpoints return a unified JSON structure:

{
  "code": 0,
  "message": "success",
  "data": {}
}
FieldTypeDescription
codenumberBusiness status code; 0 indicates success
messagestringStatus description
dataobject / arrayResponse payload

HTTP Status Codes

Status CodeMeaning
200Success
400Bad request
401Unauthorized
403Forbidden
404Not found
429Rate limit exceeded
500Internal server error

Business Error Codes

Business error codes are returned via the code field in the response body. Specific definitions will be provided in each endpoint's documentation.