Quickstart

This quickstart takes you from zero to your first authenticated response against the Airfree platform. Every Airfree service sits behind one origin and one authenticating edge, so once you can call one service you can call them all with the same token.

1. Create a developer account

Sign in through the Airfree single sign-on identity provider. Registration is self-service; your account is the same identity you use across every Airfree product. For platform access beyond your own tenant, an administrator assigns the roles your application needs.

2. Obtain an access token

The platform issues OpenID Connect access tokens. Browser apps use the Authorization Code flow with PKCE (see the Authentication guide). For server-to-server integration, use a confidential client with the client-credentials grant.

curl -s -X POST \
  https://airfree.au/auth/realms/airfree/protocol/openid-connect/token \
  -d grant_type=client_credentials \
  -d client_id=$AIRFREE_CLIENT_ID \
  -d client_secret=$AIRFREE_CLIENT_SECRET

3. Make your first call

Send the token as a bearer credential. Every request goes through the edge, which validates the token and injects the identity headers each service trusts. A missing or invalid token returns 401.

curl -s https://airfree.au/api/v1/ogc/collections \
  -H "Authorization: Bearer $AIRFREE_TOKEN"

4. Next steps

From here, read the Authentication guide for browser flows, browse the API reference for the service you need, or install an SDK to skip the boilerplate.