A Hibridlevél címbontó szolgáltatás használatával az elektronikus feladójegyzékben megadandó címeket 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átumokat 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és fejlécében szerepeljen a következő két érték:
- 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
- Authorization: Bearer <token>
- Kizárólag JSON kérésekkel és válaszokkal.
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 | A belső tesztelésre szolgáló környezet. | |
| Staging | - | |
| Production | https://address.hibridlevel.hu/api | Az éles rendszer (Az EPDB pilot során ezt használjuk.) |
Url
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
Overview
Content Tools