Skip to content
For LLMsView as Markdown·

Launch a vendor demo game (play money) ​

http
POST https://api.onehazel.com/onehazel-api/embed/v1/{key}/demo-launch

Unauthenticated. key is the operator's public embed key, never the operator id, and the browser Origin must be on the operator's allowed websites list. Body: { "key": "<connector key>", "game_code": "<game>", "language": "en", "client_type": "DESKTOP" | "MOBILE" } (language and client_type are optional). Returns { "game_url": "<https url>" } for a vendor the operator has demo-activated. It moves no money, calls no wallet and needs no player. Errors use the flat { code, message, retryable } envelope: 400 invalid_request, 403 unauthorized with details.code SURFACE_ORIGIN_NOT_ALLOWED for a website not on the list, 404 game_unknown (unknown or rotated embed key, an account that is not active, no activation, or no usable demo launch, all identical) and 404 unavailable while OneHazel Surfaces is not enabled. Rate limited per client address.

Section: Surfaces
Operation id: postEmbedV1ByKeyDemoLaunch

Authentication ​

No authentication.

Parameters ​

NameInRequiredDescription
keypathyes

Request body ​

JSON object.

Responses ​

200 { "success": true, "data": ... }

Errors return { "success": false, "error": { "code": "...", "message": "..." } } with a 4xx or 5xx status.

Example ​

bash
curl -X POST "https://api.onehazel.com/onehazel-api/embed/v1/{key}/demo-launch" \
  -H "Content-Type: application/json" \
  -d '{}'

Machine-readable: openapi.yaml, openapi.json.