The API is accessed via HTTPS at https://api.narrativ.com/ . Use JSON when sending data to API endpoints that require it. Remember to specify Content-Type: application/json
in the request headers.
When sending URLs, make sure to use the complete link, including the http://
or https://
part.
Timestamps are formatted according to the ISO 8601 standard, using the UTC time zone, and are precise to the nearest second. For example, 2017-07-26T19:48:25Z
.
API responses will always contain a few standard fields:
- info: An object containing general information about the request/response:
- error:
true
if something went wrong with the API request, orfalse
if everything is okay. - status: The HTTP status code, repeated here for convenience.
- error:
- data: A list of resources returned by the request.
- error: If an error occurred, this object will contain detailed information about the problem.
- code: A number categorizing the error.
- message: A string describing the specific error.