Pular para o conteúdo

Acesso e requisições

Sem chave, somente leitura, no servidor; formatos de IDs, datas e valores ausentes.

Sem chave, sem cadastro

A API pública não exige chave de API, token nem conta. Cada operação desta documentação é uma requisição GET anônima: envie-a e leia o JSON.

Shell
curl "https://api.nogitsu.com/v1/works?limit=3"

Somente dados públicos

A API publica o que qualquer pessoa já pode ver em nogitsu.com. Contas, bibliotecas, seções privadas do perfil, moderação e todas as operações de escrita não fazem parte da API pública e não estão documentadas aqui.

Chame-a a partir do seu servidor

Páginas web de outros sites não podem chamar a API pelo navegador: requisições entre origens são permitidas apenas a partir de nogitsu.com. Envie as requisições do seu servidor, de um script ou de uma etapa de build, e guarde uma cópia das respostas.

Identifique sua aplicação

Envie um cabeçalho User-Agent que nomeie sua aplicação, como my-app/1.0. Nossa proteção de rede bloqueia alguns agentes padrão de bibliotecas, como o que o urllib do Python envia, com uma página 403 que não é JSON.

Shell
curl -A "my-app/1.0 (+https://example.com)" "https://api.nogitsu.com/v1/genres"

IDs, datas e valores ausentes

As respostas são JSON em UTF-8. Os IDs são UUIDs. As datas são escritas como AAAA-MM-DD e os instantes como carimbos de data e hora ISO 8601 em UTC. Um valor desconhecido é null; ele nunca é substituído por 0 nem por um texto vazio.

JSON
{
  "id": "01a0cac5-388a-75ed-a3a6-4a5d2db4261e",
  "startDate": "2018-03-04",
  "season": null,
  "seasonYear": null
}