Platform

Health probes, social sign-in, the GraphQL lead query and the websocket test channel.

Base URL
https://api.reportauto.eu

Platform

Service health probes and the social sign-in handshake.

Check API health

GET/health

Liveness probe for the API host. Returns 200 while the service is serving traffic.

Authentication None

cURL
1curl "https://api.reportauto.eu/health"

Check services health

GET/services/health

Liveness probe for the downstream vehicle-data services behind the API.

Authentication None

cURL
1curl "https://api.reportauto.eu/services/health"

Query leads over GraphQL

POST/graphql

A GraphQL endpoint over the same lead data as the REST search, useful when a client wants to pick exactly the fields it renders. The Lead type exposes asking_price, status, mileage, make, model and car_condition_summary; the leads query takes a filters object.

Authentication None

  • filters accepts the same shape as the REST search — perPage, available, condition, mileageMax and so on.
cURL
1curl -X POST "https://api.reportauto.eu/graphql" \
2  -H "Content-Type: application/json" \
3  -d '{
4    "query": "query { leads(filters: { perPage: 20, available: true }) { asking_price { lower_bound upper_bound } status mileage make model car_condition_summary } }"
5  }'

Push a test websocket event

POST/test/channel

Broadcasts a test event onto the partner and request channels, for checking a websocket subscription end to end.

Authentication None

Parameters

partnersinteger

Partner channel to broadcast on.

requestsinteger

Request channel to broadcast on.

cURL
1curl -X POST "https://api.reportauto.eu/test/channel" \
2  -H "Content-Type: application/json" \
3  -d '{ "partners": 7, "requests": 112 }'

Start a social sign-in

POST/api/auth/social

Begins the OAuth handshake with an external identity provider and returns where to send the user.

Authentication None

Parameters

providerstringRequired

Identity provider, e.g. google.

cURL
1curl -X POST "https://api.reportauto.eu/api/auth/social" \
2  -H "Content-Type: application/json" \
3  -d '{ "provider": "google" }'