Images have been done. There is no good reason every application invents its own upload endpoint, its own metadata shape, and its own way of asking for a smaller version of the same picture. This is a base Images API you copy into your own service. Upload is two steps — create the record, then PUT the bytes to a short-lived URL — which keeps large binaries off the JSON API and means a failed upload does not lose the metadata. Renditions are requested rather than enumerated, and `alt` is on the base, because an image API that makes the text alternative easy to skip produces an inaccessible product downstream. Errors are RFC 9457 problem details, identical to every other base.

Tags

• Images
• Photos
• Media
• OpenAPI

Resources

• OpenAPI — OpenAPI
  OpenAPI 3.1 for the base Images API — upload, metadata, renditions and deletion.
• APIs.json — APIsJSON
  The APIs.json index for this base.
• Repository — GitHubRepository
  The repository for the base.
• Spectral Ruleset — GitHubRepository
  The errors in this base are RFC 9457 problem details, checked by the API Commons Problem Details ruleset. The base lints clean under it.

Return to All Base Schema Page