Conventions

Answers, attribution, times, pagination, errors and versioning.

• AnswersThe envelope every answer uses - data and meta - and the headers that come with it.
• AttributionThe display requirement - show meta.attribution with the data - and what no resale or redistribution of raw data means in practice.
• TimesHow to pass times (unix seconds or RFC 3339) and how answers carry them (t in unix seconds, ISO 8601 UTC strings).
• PaginationCursor paging - limit, meta.next_cursor and cursor - and which way each list walks.
• ErrorsThe error shape and every error code the API answers, with its cause, what to do and whether to retry.
• VersioningThe v1 promise - additive changes only - and how a breaking change would be announced.