Content

Get an article

Reads one article in one language, with its content as markdown. Every status is readable.

GET
/sites/{site_id}/articles/{article_id}
cURL
curl --request GET \
  --url 'https://api.notiondesk.so/sites/{site_id}/articles/{article_id}' \
  --header 'Authorization: Bearer <token>'

Autorizações

  • Authorizationstringheader

    api_key · http · bearer

    read
  • Authorizationstringheader

    oauth · oauth2

    read

Parâmetros de caminho

  • site_idstringobrigatório

    The id of a site from List sites.

  • article_idstringobrigatório

    The id of an article from List articles.

Parâmetros de consulta

  • localestring

    The language to read. Defaults to the site's default_locale; an empty value reads the default.

Cabeçalhos

  • nd-versionstring

    The contract version your integration was written against. Without it, the request uses the current version. An unknown value answers 400 invalid_version.

Respostas

The article.

Cabeçalhos

  • nd-versionstring

    The contract version that answered the request.

  • X-RateLimit-Limitinteger

    Requests allowed per minute: 120 for GET, 20 for writes, per key or OAuth grant.

  • X-RateLimit-Remaininginteger

    Requests left in the current window.

  • Retry-Afterinteger

    Seconds until the next request is accepted; 0 while requests remain.

  • idstringobrigatório

    The article identifier.

  • typestringobrigatório
  • titlestring | nullobrigatório

    The article title.

  • slugstring | nullobrigatório

    The article's path segment on the site.

  • textstringobrigatório

    The article content as markdown, empty when no content is stored yet.

  • urlstring | nullobrigatório

    The article's public address.

  • localestringobrigatório

    The language of this response.

  • last_updatedstring | nullobrigatório

    When the article last changed.

  • categoryobject | nullobrigatório

    The article's main category.

    • idstringobrigatório
    • titlestring | nullobrigatório
    • slugstring | nullobrigatório
  • tagsstring[]obrigatório

    The slugs of the article's tags.

  • truncatedbooleanobrigatório

    true when text was cut at the 200,000-byte ceiling; the cut always falls on a whole character.

  • authorobject | nullobrigatório

    The article author.

    • namestring | nullobrigatório
  • statusstringobrigatório
  • content_availablebooleanobrigatório

    Whether Notiondesk holds content for this language yet.

  • sync_in_progressbooleanobrigatório

    Whether a sync of this article is running.

  • sync_timeoutbooleanobrigatório

    Whether the last sync of this article timed out.

  • sync_failedbooleanobrigatório

    Whether the last sync of this article failed.

  • sync_error_codestring | nullobrigatório

    Why the last sync failed.