Errors
Particle Space uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the2xxrange indicate success. Codes in the4xxrange indicate an error that failed given the information provided (e.g., a required parameter was omitted). Codes in the5xxrange indicate an error with Particle Space's servers (these are rare). Some4xxerrors that could be handled programmatically include an error code that briefly explains the error reported.
HTTP STATUS CODE SUMMARY | |
---|---|
400-BAD_REQUEST | The request was unacceptable, often due to missing a required parameter. (e.g., malformed request syntax, invalid request message framing, or deceptive request routing). |
401-UNAUTHORIZED | No valid API key was provided. |
404-NOT_FOUND | The requested resource was not found. |
405-NOT_SAVED | The requested method is not allowed. |
418-USER_ALREADY_EXISTS | User already exists. Please try again. |