접근과 요청

키 없이, 읽기 전용으로, 서버에서 사용하기. ID, 날짜, 누락된 값의 형식.

키도 가입도 필요 없어요

공개 API에는 API 키, 토큰, 계정이 필요 없어요. 이 문서의 모든 작업은 익명 GET 요청이에요. 요청을 보내고 JSON을 읽으면 돼요.

Shell

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

API는 nogitsu.com에서 누구나 이미 볼 수 있는 것만 공개해요. 계정, 라이브러리, 프로필의 비공개 섹션, 운영 관리, 모든 쓰기 작업은 공개 API에 포함되지 않으며 여기에서 다루지 않아요.

다른 사이트의 웹 페이지는 브라우저에서 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
}