Skip to content

Interactive docs

The pages here cover the basics. For the full spec, use the interactive reference.

The interactive reference serves the same OpenAPI spec: all providers, schemas, examples, and generated snippets.

Interactive UI

UI URL Best for
Scalar /scalar/v1 Easier navigation, better search

What's in it

  • Full endpoint inventory by provider
  • Request/response schemas
  • Sample payloads
  • Code snippets for common languages
  • Response codes and error models
  • Auth requirements

Read-only — no live calls

Try it = disabled

Scalar is for discovery and reference. Live requests come only from your backend or your own API tools.

That keeps auth, auditing, and rate limiting tied to the real service account rather than to ad-hoc browser sessions.

Docs credentials

The docs have a separate login from the API:

  • API access: service account with client_id + client_secret
  • Docs access: developer account with username + password

Login flow

  1. Open Scalar
  2. Redirect to Keycloak
  3. Login with your developer account
  4. Back to the docs with the full spec

Testing endpoints

curl

Grab the route from Scalar, get a JWT via client_credentials, run from your terminal or backend:

TOKEN=$(curl -s -X POST \
  https://auth.insurancegateway.gr/realms/estia/protocol/openid-connect/token \
  -d "grant_type=client_credentials" \
  -d "client_id=$YOUR_CLIENT_ID" \
  -d "client_secret=$YOUR_CLIENT_SECRET" | jq -r .access_token)

curl -X GET https://api.insurancegateway.gr/intersalonica/auto/brands \
  -H "Authorization: Bearer $TOKEN"

Postman / Bruno / Insomnia

  1. Import the OpenAPI spec (or ask support for it)
  2. Setup OAuth 2.0 with client_credentials
  3. Service-account credentials in the environment
  4. Run requests

Application code

Working examples:

Access for more developers

Send to Support:

  • Developer email
  • How many people need access

We'll send credentials securely.

Troubleshooting

Redirect to Keycloak doesn't happen

  • Cookies blocked in the browser?
  • Try a private window to rule out stale session

Login works but spec doesn't load

  • Refresh and login again
  • Ask us to confirm the account is still active

Expected "Try it"

Disabled by design. For live requests → curl, Bruno, Postman, or your backend.