Interactive docs¶

Οι σελίδες εδώ καλύπτουν τα βασικά. Για το πλήρες spec, χρησιμοποιήστε το interactive reference.

Το interactive reference διαβάζει το ίδιο OpenAPI spec: όλοι οι providers, schemas, examples και generated snippets.

Interactive UI¶

UI	URL	Πότε ταιριάζει
Scalar	`/scalar/v1`	Πιο άνετη πλοήγηση, καλύτερο search

Τι θα βρείτε¶

Full endpoint inventory ανά provider
Request/response schemas
Sample payloads
Code snippets για κοινές γλώσσες
Response codes και error models
Auth requirements

Read-only — όχι live calls¶

Try it = disabled

Το Scalar είναι για αναζήτηση και reference. Live requests φεύγουν μόνο από το backend σας ή από τα δικά σας API tools.

Έτσι το auth, auditing και rate limiting δένονται με το πραγματικό service account και όχι με αποσπασματικά browser sessions.

Credentials για τα docs¶

Τα docs έχουν ξεχωριστό login από το API:

API access: service account με client_id + client_secret
Docs access: developer account με username + password

Ανοίξτε Scalar
Redirect στο Keycloak
Login με τον developer account σας
Επιστροφή στο docs με το full spec

Testing endpoints¶

curl¶

Πάρτε το route από το Scalar, βγάλτε JWT με client_credentials και τρέξτε από terminal ή 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¶

Import το OpenAPI spec (ή ζητήστε το από support)
Setup OAuth 2.0 με client_credentials
Service-account credentials στο environment
Τρέξτε requests

Application code¶

Έτοιμα παραδείγματα:

Πρόσβαση για περισσότερους developers¶

Στείλτε στο Support:

email του developer
πόσα άτομα χρειάζονται access

Θα σας στείλουμε credentials με ασφαλή τρόπο.

Troubleshooting¶

Δεν γίνεται redirect στο Keycloak¶

Cookies blocked στον browser;
Δοκιμάστε private window για να αποκλείσετε stale session

Refresh και ξανά login
Ζητήστε μας να επιβεβαιώσουμε ότι ο λογαριασμός είναι active

Περιμένατε "Try it"¶

Disabled by design. Για live requests → curl, Bruno, Postman, ή backend σας.