Skip to content

Add burn451.cloud 1.0.0 β€” read-later + Vault + YouTube digest API#2440

Open
Fisher521 wants to merge 1 commit into
APIs-guru:mainfrom
Fisher521:add-burn451
Open

Add burn451.cloud 1.0.0 β€” read-later + Vault + YouTube digest API#2440
Fisher521 wants to merge 1 commit into
APIs-guru:mainfrom
Fisher521:add-burn451

Conversation

@Fisher521

Copy link
Copy Markdown

Add burn451.cloud

Spec: APIs/burn451.cloud/1.0.0/openapi.json

Burn 451 is a read-later app with a 24-hour countdown: save an article, read today, or it's gone. This spec documents the public HTTP API at https://www.burn451.cloud.

Endpoints (4 paths, 5 operations)

  • POST /api/save β€” save a URL to the reading queue. Bearer Authorization or X-Burn-Token header; token generated in the iOS Burn app under Settings β†’ MCP Server.
  • GET /api/vault/{id} β€” fetch a curated Vault collection (Karpathy, Simon Willison, Paul Graham, swyx, and others). No auth.
  • GET /api/vault/article β€” fetch a single Vault article with cleaned, Jina-extracted content.
  • POST /api/youtube-digest β€” digest any public YouTube video using Innertube captions. No auth, no API key.

Internal admin endpoints (cache revalidation, service-role operations) are intentionally excluded.

Spec coverage

  • OpenAPI 3.1.0
  • info.contact.email = hi@burn451.cloud for ownership verification
  • info.x-origin.url = https://www.burn451.cloud/openapi.json (kept in sync with prod)
  • info.x-logo set
  • info.x-apisguru-categories: developer_tools
  • 9 reusable $ref schemas, 2 securitySchemes (http/bearer + apiKey header)

Validation

Spec validates clean under @redocly/cli lint (recommended ruleset, zero errors, zero warnings).

Live

Happy to adjust anything β€” naming, category, logo β€” on request.

Burn 451 β€” a read-later app with a 24-hour countdown (save an article,
read today, or it's gone). This spec covers the public HTTP API exposed
at https://www.burn451.cloud:

- POST /api/save β€” save a URL to the reading queue (bearer/X-Burn-Token)
- GET  /api/vault/{id} β€” fetch a curated Vault collection
- GET  /api/vault/article β€” fetch a single Vault article with cleaned content
- POST /api/youtube-digest β€” generate a digest for a YouTube video

Internal admin endpoints (cache revalidation, service-role ops) are
intentionally excluded.

Spec: https://www.burn451.cloud/openapi.json
Docs: https://www.burn451.cloud/developers

Spec validates clean under @redocly/cli.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant