Skip to content

/problems/resource-not-found⚓︎

Problem

This is a description of a specific error response that you can receive when using the INVERS OneAPI via REST.1

Check out our API Basics to learn more about the basic structure of all error responses and to find out how you should handle them.

{
    "type": "/problems/resource-not-found",
    "type_documentation": "https://developers.invers.com/problems/resource-not-found",
    "title": "The resource cannot be found.",
    "status": 404,
    "detail": "…",
    "flow_id": "e1b8e6dd-7df4-435c-b8e6-dd7df4835c4d"
}

Meaning⚓︎

This type of problem occurs when a requested resource with a certain ID does not exist or a necessary permission is missing.

Details⚓︎

  • Use the error response’s type property to handle specific errors and exception handling within your application. It’s comparable to an error code.
  • The detail property contains additional, more human-readable information about the problem or error. This is explanatory text and you should not have any exception handling and error handling code depend on it, as it may change.

Detail examples⚓︎

The following examples are typical texts which you might receive in the error response’s detail property. Note that it is not a complete list of all possible cases. Therefore expect to receive error responses with a detail property value not listed below.

Example problem details⚓︎

Vehicle with id ‘MT3T3’ was not found.

You have specified to get a vehicle with id ‘MT3T3’, but there is no vehicle with that id or the vehicles.ro permission is missing.

Possible solutions:

  • Check if your requested vehicle exists
  • Check if you have the required permissions
  • Check if there is a typo in the id
Vehicle with id ‘MT3T3’ has no telematics unit.

You have specified to get the telematics unit of the vehicle with id ‘MT3T3’, but vehicle has no telematics unit or the vehicles.ro permission is missing.

Possible solutions:

  • Check if your requested vehicle has a telematcs unit
  • Check if you have the required permissions
  • Check if there is a typo in the id
Latest vehicle state for vehicle with id ‘MT3T3’ was not found.

You have specified to get the latest vehicle state of the vehicle with id ‘MT3T3’, but the vehicle has no state or the vehicles.ro permission is missing.

Possible solutions:

  • Check if your requested vehicle has a state
  • Check if you have the required permissions
  • Wait a short time and retry your request. Managed vehicles report at regular intervals
  • Check the vehicles connection status
  • Check if there is a typo in the id

Further reading⚓︎

  1. The flow_id is specific to each API call, so it will be different in your case. However, type, title and status will match your actual error response if you receive the error described on this page. ↩