1. API Technical Specifications
FoxCloud OpenAPI
Vpp Flow
  • Vpp Flow
  • Full API Reference
  • What's New & Milestones
  • Getting Started
    • 1. Overview & Integration Scope
    • 2. Environments & Prerequisites
  • End-User Enrollment & OAuth Flow
    • 0. Introduction
    • 1. The User Authorization Journey
    • 2. OAuth Token Operating Model
    • 3. Implementation Guide
  • API Technical Specifications
    • 1. Universal Request Rules
    • 2. Rate Limiting Strategy
    • 3. Response Structure
    • 4. Error Code Reference
  • Telemetry & Data Acquisition
    • 1. Data Pipeline & Scaling Strategy
    • 2. Telemetry Data Query (Real-time)
    • 4. Telemetry Variable Dictionary
    • 5. System Performance & SLA
    • 3. Device Configuration & Settings: Pre-Dispatch State Awareness
  • Control Commands & Dispatch
    • 1. Core Dispatch Architecture: Scheduler V3
    • 2. Scheduler V3 Operations
    • 3. Real-time Device Settings
    • 4. Strategic Roadmap: Scaling for Massive Fleets
  • FAQ
    • Troubleshooting Quick Guide
  1. API Technical Specifications

4. Error Code Reference

When an API call fails, the errno and msg fields indicate the specific reason. Below are the most common error codes.

5.1 Common Error Codes#

CodeMessageDescriptionSuggested Action
0SUCCESSThe request was processed successfully.None.
40257INVALID_PARAMETEROne or more parameters in the request body are invalid.Check parameter format (e.g., SN length, date format).
41201SYSTEM_ERRORAn unexpected error occurred on the server side.Retry the request. If persistent, contact support.
41808INVALID_TOKENThe provided OAuth token is expired or malformed.Request a new OAuth token using your client_id and client_secret.
41811PERMISSION_DENIEDThe OAuth token does not have permission for the requested resource.Confirm that device enrollment is complete and that the token belongs to the correct Client App.
41930INVALID_DEVICEThe specified device Serial Number (SN) does not exist.Validate the SN against the device list.
42051IN_OTHER_VPPThe device is currently bound to another VPP platform.The user must unbind the device from the previous platform.
42052INCOMPATIBLE_HARDWAREThe hardware model is not supported by the VPP program.Check the Device Compatibility Matrix.
42054INVALID_DEVICE_OF_USERThe user does not own the requested device.Verify the device binding relationship.
40404REQUEST_EXCEEDS_THE_LIMITThe request frequency exceeds the rate limit.Implement exponential backoff in your retry logic.
Note: A 4xx client error indicates a problem with the request itself. A 5xx server error indicates a temporary issue on the FoxCloud side.
Modified at 2026-08-04 03:31:26
Previous
3. Response Structure
Next
1. Data Pipeline & Scaling Strategy
Built with