Estia API Developer Portal

Το Estia API ενοποιεί 20+ ασφαλιστικούς providers πίσω από ένα REST API. Αντί για ξεχωριστή υλοποίηση ανά provider, δουλεύετε με ένα σταθερό integration layer.

Εδώ θα βρείτε ό,τι χρειάζεστε για να ξεκινήσετε: auth, πρώτο request, code samples, troubleshooting και support.

Start here

Section	Τι θα βρείτε
Getting started	Πάρτε token και κάντε το πρώτο request
Authentication	Keycloak client_credentials flow
Code samples	Έτοιμοι clients σε C#, Node.js, Python
Endpoint examples	Αντιπροσωπευτικές κλήσεις ανά κατηγορία
Rate limits	Όρια, retries και throughput planning
Error handling	ProblemDetails responses και correlation IDs
Error reference	Unified error contract (422/502/504) σε όλους τους providers
Interactive docs	Full OpenAPI spec σε Scalar
Support	Πώς να ζητήσετε βοήθεια

Core URLs

Service	URL
API base	https://api.insurancegateway.gr
Keycloak	https://auth.insurancegateway.gr
Scalar	https://api.insurancegateway.gr/scalar/v1
Readiness	https://api.insurancegateway.gr/health/ready

Πρώτη φορά;

Ξεκινήστε από το Getting started — από credentials σε working call σε λίγα λεπτά.

Interactive API reference

Για το πλήρες inventory — 1.484 endpoints — ανοίξτε το interactive reference:

Scalar (recommended)

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

Το Scalar χρησιμοποιεί browser login μέσω Keycloak — για developers που διαβάζουν το spec.

Το backend σας χρησιμοποιεί τα service-account credentials (client_id + client_secret) για να βγάλει JWT.

Τα interactive docs είναι read-only. Το Try it είναι disabled, ώστε live traffic να φεύγει μόνο από το δικό σας backend.

Παράδειγμα auth

Κάθε call χρειάζεται bearer token από το Keycloak:

curl -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>

Στέλνετε το token ως Authorization: Bearer <jwt>. Full flow στο Authentication.