アクセスとリクエスト

キー不要、読み取り専用、サーバー側での利用。ID、日付、欠損値の形式。

キーも登録も不要

公開APIにはAPIキー、トークン、アカウントは必要ありません。このドキュメントのすべての操作は匿名のGETリクエストです。送信してJSONを読み取ってください。

Shell

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

APIが公開するのは、nogitsu.comで誰でもすでに見られる情報です。アカウント、ライブラリ、プロフィールの非公開セクション、モデレーション、すべての書き込み操作は公開APIに含まれず、ここには記載していません。

他サイトのWebページは、ブラウザからAPIを呼び出せません。クロスオリジンリクエストはnogitsu.comからのみ許可されています。リクエストはご自身のサーバー、スクリプト、ビルドステップから送信し、レスポンスのコピーを保存してください。

アプリケーション名を示す User-Agent ヘッダーを送ってください（例：my-app/1.0）。ネットワーク保護により、Python の urllib が送るものなど一部のライブラリの既定のエージェントは、JSON ではない 403 ページでブロックされます。

Shell

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

レスポンスはUTF-8のJSONです。IDはUUIDです。日付はYYYY-MM-DD、日時はUTCのISO 8601タイムスタンプで表記します。不明な値はnullで、0や空のテキストに置き換えられることはありません。

JSON

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