Developer preview. This reference describes a local metadata mock. Developer credentials, hosted sandbox calls and production API access are not available through this preview.

Developer API reference 1.0.0

Local metadata mock and fail-closed city boundary only. OAuth, app registration, rate limiting, signed pagination, credentials, commerce and webhooks are pending. This contract is not a production availability claim.

Wire path: /developer/v1. OpenAPI format: 3.1.1.

Download versioned OpenAPI YAML · Download OpenAPI JSON · Latest v1 schema

Errors use application/problem+json. Responses carry an opaque request ID, X-AfricaOne-API-Version: 1.0 and Cache-Control: no-store.

GET /developer/v1/capabilities

Inspect availability flags

Public sanitized metadata; local mock only.

Access: public metadata.

Release: local-mock-only. Quotas: pending-integration.

Responses: 200, 404, 405, 503.

GET /developer/v1/regions

Inspect approved regions (none enabled in this slice)

Public sanitized metadata; local mock only.

Access: public metadata.

Release: local-mock-only. Quotas: pending-integration.

Responses: 200, 404, 405, 503.

GET /developer/v1/status

Inspect implementation readiness

Public sanitized metadata; local mock only.

Access: public metadata.

Release: local-mock-only. Quotas: pending-integration.

Responses: 200, 404, 405, 503.

GET /developer/v1/cities

Read reviewed city metadata

Requires an injected trusted authorizer and reviewed city provider. The standalone mock has no authorizer and returns 401. No signed pagination yet: a result larger than limit returns 503 instead of dropping records. No production integration or PII.

Access: city.public.read.

Release: local-mock-only. Quotas: pending-integration.

Responses: 200, 400, 401, 403, 404, 405, 503.

Security and availability

OAuth, app registration, credential management, signed pagination, rate limiting and webhooks are being built. Commerce and regulated assets are disabled. No player identity, balance or live location is exposed by this mock.