OneSay Platform

API Playground

Private local M1 candidate. Hosting and external acceptance remain open.

Status: PARTIAL / LOCAL SYNTHETIC CANONICAL SDK

The local interactive Playground executes exactly three generated canonical read operations: listProjects, listCapabilities and listActions. It uses the actual BrowserControlClient, its generated operation registry and an injected in-process Test transport. The transport validates canonical Staging authority/path construction, GET, no body, bearer-token placement, cache: no-store, credentials: omit, redirect: error and referrerPolicy: no-referrer before returning synthetic fixtures.

There is no ambient browser-network fallback. The environment, token provider, transport and fixtures are fixed in code; Production credentials, mutation operations and Legacy routes cannot be selected. Required CI must execute the native controls in Gecko and WebKit with zero external requests before the browser proof is accepted.

Source and provenance

Surface: playground
Canonical source: docs/developer/API_PLAYGROUND.md
Canonical spec SHA-256: b4b9c06106eeaacd9b3d12592b48d82b4247853bea70c203aa8fe5e76500d37f

View original Markdown

# API Playground

Status: `PARTIAL / LOCAL SYNTHETIC CANONICAL SDK`

The local interactive Playground executes exactly three generated canonical
read operations: `listProjects`, `listCapabilities` and `listActions`. It uses
the actual `BrowserControlClient`, its generated operation registry and an
injected in-process Test transport. The transport validates canonical Staging
authority/path construction, `GET`, no body, bearer-token placement,
`cache: no-store`, `credentials: omit`, `redirect: error` and
`referrerPolicy: no-referrer` before returning synthetic fixtures.

There is no ambient browser-network fallback. The environment, token provider,
transport and fixtures are fixed in code; Production credentials, mutation
operations and Legacy routes cannot be selected. Required CI must execute the
native controls in Gecko and WebKit with zero external requests before the
browser proof is accepted.

Interactive API Playground — synthetic Test environment