ahlan hamad

Changelog

The first table is generated from openapi.yaml on every site build, so it always matches the contract. The dated log below it is written by hand. See also the versioning and deprecation policy.

Release status

ReleaseStatusEndpoints live
v1.0Partly live1 / 5
v1.1Not yet live0 / 2
v1.2Not yet live0 / 8

v1.0

v1.1

v1.2

Log

Guides, changelog and a Postman collection

Docs

New guides in English and Arabic: sandbox and testing, API key or OAuth app, webhooks (with signature samples in Node, Python and PHP), versioning and deprecation, and a preview of the planned OAuth flow. A Postman collection generated from openapi.yaml is at /developers/postman.json. The reference now marks which endpoints are live.

API keys, self-serve sandbox and GET /v1/company

Addedv1.0

Scoped API keys under Integrations → API keys: ah_test_ keys for sandbox companies now, ah_live_ keys once the API terms are published. Anyone signed in can create a sandbox company with generated data. GET /v1/company is the first live endpoint; every response carries X-Request-Id and rate-limit headers, and errors use application/problem+json. The developer docs site opened at /developers.

Draft v1 contract published

Docs

The v1 contract (openapi.yaml, draft 1) and the quickstart were published ahead of the implementation so partners can build in parallel: v1.0 reads, v1.1 attendance, v1.2 webhooks.