4SDeveloper
API ReferenceResources
日本語
API Reference
OAuth / OIDC
  • Introduction
  • Authentication Flow
  • Discovery / JWKS
  • Token Endpoint
  • ID Token
  • Token Revocation
  • Calling the APIs
  • Rate Limits
  • Error Reference
  • Integration Examples
  • Demo App
Schemas
Users / Profile
Card exchange / Meet log
Organizations
Organizations (Admin)
Events
Events (Admin)
Communities
Communities (Admin)
Playlists
  • Playlist list
  • Playlist detail
  • Playlist items
  • Playlist map pins
  • Preview an external URL for submission
  • Submit an event
Playlists (Admin)
Chat
Notifications
Push notifications
Bookmarks
Misc
API Reference

Playlists

  • GET/playlists
    Playlist listSearch and list public playlists.
  • GET/playlists/:playlistId
    Playlist detailRetrieve a playlist's detail (items via a separate endpoint).
  • GET/playlists/:playlistId/items
    Playlist itemsRetrieve playlist items. `page` uses numbered pagination, `cursor` uses cursor pagination. groupByDate=true returns date-grouped results.
  • GET/playlists/:playlistId/geojson
    Playlist map pinsReturns the 4S events in the playlist that have coordinates as a GeoJSON FeatureCollection. Not paginated; narrow the result with bbox. Filters have the same meaning as GET /playlists/:playlistId/items.
  • POST/playlists/:playlistId/preview-external
    Preview an external URL for submissionFetch title, description, image and schedules from an external URL's OG / JSON-LD for the submission form. Only available on playlists that accept submissions.
  • POST/playlists/:playlistId/item-requests
    Submit an eventSubmit an event to a playlist. The item is created with status=PENDING and stays hidden until a community admin approves it. Approval and rejection are done through the /manage/playlists endpoints.
© 4SDeveloper portal for the 4S platform.