Saltar al contenido

Acceso y solicitudes

Sin clave, solo lectura, desde el servidor; formatos de identificadores, fechas y valores ausentes.

Sin clave ni registro

La API pública no necesita clave de API, token ni cuenta. Cada operación de esta documentación es una solicitud GET anónima: envíala y lee el JSON.

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

Solo datos públicos

La API publica lo que cualquiera ya puede ver en nogitsu.com. Las cuentas, las bibliotecas, las secciones privadas del perfil, la moderación y todas las operaciones de escritura no forman parte de la API pública y no se documentan aquí.

Llámala desde tu servidor

Las páginas web de otros sitios no pueden llamar a la API desde el navegador: las solicitudes entre orígenes solo se permiten desde nogitsu.com. Envía las solicitudes desde tu servidor, un script o un paso de compilación, y guarda una copia de las respuestas.

Identifica tu aplicación

Envía una cabecera User-Agent que nombre tu aplicación, como my-app/1.0. Nuestra protección de red bloquea algunos agentes predeterminados de bibliotecas, como el que envía urllib de Python, con una página 403 que no es JSON.

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

Identificadores, fechas y valores ausentes

Las respuestas son JSON en UTF-8. Los identificadores son UUID. Las fechas se escriben como AAAA-MM-DD y los instantes como marcas de tiempo ISO 8601 en UTC. Un valor desconocido es null; nunca se sustituye por 0 ni por un texto vacío.

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