Found Hero provides a simple yet powerful API to build and automate a lost and found solution into your management software.
The Found Hero API is organized around REST. Our API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP authentication and HTTP verbs, which are understood by off-the-shelf HTTP clients.
We support cross-origin resource sharing, allowing you to interact securely with our API from a client-side web application (though you should never expose your secret access token in any public website's client-side code).
To obtain an API key, do the following:
Found Hero also provides a sandbox environment that you can use for development and testing. This environment acts the same way as production. All user accounts, passwords, and locations are independent of the production environment. To use our sandbox environment, you'll need to create a sandbox account as well.
The API accepts only HTTP requests with
application/jsonand a JSON body depending on the operation to be performed. The Found Hero API is served over HTTPS and unencrypted HTTP connections are not supported.
For the production environment, all HTTP requests should use the following base URL:
If you are using the Found Hero API within the sandbox environment, use the following base URL:
All API requests return a JSON-encoded response with
application/json. If the request is successful, the HTTP status code returned is
200and the JSON content contains appropriate result according to the operation.
For a typical HTTP request, the returned JSON object has the following properties: