PlatPhorm API
API Recipes
Practical public-safe and protected API, MCP, OpenContent, Podcasts, trace, platphormctl, Evals, Sandbox, BrowserOps, and CI workflows.
Call a public APIUse a public GET route, propagate trace headers, and inspect structured ok/data or ok/error output.Call a protected APIUse PLATPHORM_API_KEY with Authorization bearer or X-PlatPhorm-API-Key. Never expose the key in clients or public logs.Call an MCP toolUse JSON-RPC 2.0 initialize, tools/list, and tools/call against /api/mcp.OpenContent ingestURL -> OpenContent ingest -> metadata validation -> share card validation -> Docs export -> Insights -> Echo -> Sheets.Podcast feed ingestPodcast feed URL -> Podcasts ingest -> RSS validation -> episode metadata -> Reader -> Docs -> Insights -> Echo -> Sheets.Trace-linked API callSend traceparent, tracestate, X-PlatPhorm-Trace-Id, X-PlatPhorm-Request-Id, and service/operation headers.Use platphormctlInspect, validate, and dry-run API, OpenContent, Podcasts, MCP, policy, and harness chains.Run an evalUse Evals as a protected integration; public docs remain catalog-only until an authorized run exists.Run a sandbox testUse Sandbox for safe execution and schema validation; protected execution requires PLATPHORM_API_KEY.Use BrowserOpsUse BrowserOps for browser journey proof, screenshots, and route checks; run triggers are protected.