FAQ¶

Is Swagger enough, or should I read this guide too?¶

Use both. Swagger/OpenAPI is the contract source of truth for endpoint/schema shape. This guide covers integration behavior, workflows, and operating practices.

Why do I get `204 No Content` sometimes?¶

204 means the queue currently has no message available for that endpoint. Use long polling (timeOut) or poll again.

Why are success codes `210`, `211`, and `212` instead of only `200`?¶

EuroAPI uses these to identify message categories directly at HTTP layer:

210 => REQUEST
211 => SCAN
212 => VERIFY

Should I POST a response when I receive `VERIFY`?¶

No. Only REQUEST messages require assignment response via POST /sortation.

Should I send `Type` in POST payloads?¶

You can omit it for normal integration. For sortation assignment, send TrackID and Destination. For destination updates, send destination status/light/text fields as needed.

Are enum values case-sensitive?¶

For POST /destination enum fields (DestinationStatus, LightStatus, LightColor), input parsing is case-insensitive. Use canonical values from Keywords and Casing.

Can I use long polling on both queues?¶

Yes. timeOut works on both GET /sortation and GET /destination.

How do I clear destination display text?¶

Send DestinationText as an empty string ("") in POST /destination.

What is the fastest way to validate connectivity?¶

Call GET /status first, then GET /sortation?timeOut=2 and GET /destination?timeOut=2.

Can multiple clients connect at once?¶

The service can accept multiple connections. For deterministic queue handling, use one active consumer per queue path.