A Hibridlevél címbontó szolgáltatás használatával a leveleinek címzettjeit könnyedén felbonthatja a Postai díjkedvezmény elérése érdekében.

A szolgáltatás technikai alapjai

A szolgáltatás egy REST webszolgáltatás formájában érhető el,
- Kizárólag JSON kérésekkel és válaszokkal.
  - A kérés fejlécében szerepeljen a következő két érték:
    - Content-Type: application/json
    - Accept: application/json
  - A dátumok kizárólag a következő formátumban lehet átadni: yyyy-MM-dd (pl. 2017-09-19)
  - A felsorolástípusoknál pedig az elem nevét, nem pedig az integer értékét várjuk.
- A kérésekben fejlécben meg kell adni a hozzáférési tokent a következő formátumban:
  - Authorization: Bearer <token>
    - A Bearer és a token közé kötelező a szóköz és
    - Értelemszerűen a relációjelekre nincs szükség, csak a token behelyettesítésének helyét adja meg

Egy teljes, kidumpolt példa kérés itt található.

A szolgáltatás környezeteinek elérési útjai

Név	Url	Magyarázat
Testing	https://taddress.hibridlevel.xyz/api	A belső tesztelésre szolgáló környezet. (Az EPDB pilot során ezt használjuk.)
Staging	-
Production	-

Az url-ek csak az api végpont gyökerét jelölik, az egyes erőforrásokon elérhető metódusok elérési útjai ezeket egészítik ki. Tehát ha a /mailer/batch-recognize elérési úttal jelölt metódust akarja meghívni a testing környezeten, a következő url-re kell elküldenie a kérést: https://taddress.hibridlevel.xyz/api/mailer/batch-recognize

Az elérhető erőforrások, rajtuk végezhető műveletek és a hozzájuk szükséges adatátviteli objektumok