Sending and Receiving Data
==========================

Data formats
------------

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``.


Response fields
---------------

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, or ``false``
    if everything is okay.
  * status: The HTTP status code, repeated here for convenience.

* 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.