Sandbox API

Local development

make up, smoke, Postman, and docs on the gateway host.

Environments

EnvironmentGateway hostNotes
Localhttp://localhost:8780make up (GCS + Pub/Sub emulator)
Productionhttps://sandbox.turing.com (or your ingress)Same paths — only the host changes

Docs and OpenAPI are always on the same hostname as the API:

ResourcePath
Integrator docs/docs
Platform OpenAPI/openapi/sandbox-platform.yaml
Engineer Swagger/internal/swagger
KeyHive (local only)http://localhost:8790

Use SANDBOX_GATEWAY_URL in scripts so curl examples work everywhere:

export SANDBOX_GATEWAY_URL="${SANDBOX_GATEWAY_URL:-http://localhost:8780}"

Quick start

make setup && make up && make smoke && make e2e-local

Postman

Import from the repo:

  • docs/postman/sandbox_platform.postman_collection.json
  • docs/postman/sandbox.local.postman_environment.json (local)

Regenerate: make postman

Engineering Swagger

Cluster operators only: /internal/swagger on the gateway host (not for integrators).

Next steps