Zindies API
API by Zindies · rest
Public REST API for Zindies — independent zine creators / publications / shops / events. 公開 read エンドポイントは認証不要。書き込み(管理)エンドポイントは 2 系統の Bearer トークンで認証する: - OAuth 2.0 (Authorization Code + PKCE): 第三者 Application 向け。ユーザーの 同意時に「操作を任せる Creator/Place (= Anchor)」が選択され、発行トークンは その Anchor と scope に束縛される。 - Personal Access Token (PAT): 第一者(自分自身)向け。Userapi_token を Bearer で渡す。自分が管理する全エンティティ・全 scope 相当。 書き込みは scope ∧ Anchor 束縛 ∧ ユーザーの管理権限 の三段で認可される。 管理エンドポイントは Anchor 配下にネストする (/v1/creators/{token}/..., /v1/places/{token}/...)。 - Canonical host: https://api.zindies.co - OAuth authorize/token host: https://zindies.co/oauth/* All list endpoints support pagination (page, per up to 100) and random=N (mutually exclusive with page/per). Index responses include Last-Modified and ETag for conditional GET (If-None-Match returns 304). Multi-language: pass ?locale=ja|en|ko|zh-TW. The translation is server-side and does not affect the user's session locale.
Endpoint: https://api.zindies.co/
Verification: observed. Source: crawl.
Capabilities (55)
- List public announcements
- Get a single announcement by id
- List public creations (zines / publications)
- Get a single creation by token
- List public creators (authors / artists)
- List a creator's announcements
- Create an announcement under a creator
- Get a creator's announcement
- Update a creator's announcement
- Delete a creator's announcement
- List creations whose primary creator is this creator
- Create a creation with this creator as primary
- Get a creation
- Update a creation
- Delete a creation
- List a creator's diary entries (newest first)
- Get a creator's diary entry for a date
- Upsert a creator's diary entry for a date
- Upsert a creator's diary entry (alias of PUT)
- Delete a creator's diary entry for a date
- List a creator's events
- Create a DayEvent under a creator
- Get a creator's event
- Update a creator's event
- Delete a creator's event