Hibakezelés (Error Handling)

A Partner API szabványos HTTP állapotkódokat használ, és egységes JSON hibaválaszokat ad vissza.

Hibaválasz formátum

Minden hiba a következő struktúrát követi:

{
	"statusCode": 400,
	"message": "Validation failed",
	"error": "Bad Request"
}

Állapotkódok (Status Codes)

Kód	Hiba	Leírás
`400`	Bad Request	Érvénytelen kérés törzs, hiányzó kötelező mezők vagy érvényesítési hiba
`401`	Unauthorized	Hiányzó, érvénytelen vagy lejárt hitelesítési adatok
`403`	Forbidden	Érvényes hitelesítési adatok, de elégtelen jogosultság ehhez a művelethez
`404`	Not Found	A kért erőforrás nem létezik
`409`	Conflict	Duplikált kérés észlelve (pl. duplikált idempotencia-kulcs eltérő tartalommal)
`429`	Too Many Requests	Kéréslimit túllépve
`500`	Internal Server Error	Váratlan hiba történt a szerveren

Validációs hibák (Validation Errors)

A kérésvalidáció által okozott 400-as hibáknál a message mező tartalmazhatja, mely mezők nem feleltek meg az érvényesítésnek:

{
	"statusCode": 400,
	"message": [
		"products.0.productId must be a UUID",
		"products.0.startAt must be a valid ISO 8601 date",
		"payment.type must be one of: CARD, GOOGLE_PAY, APPLE_PAY, IDEAL, REVOLUT, BANCONTACT"
	],
	"error": "Bad Request"
}

Legjobb gyakorlatok (Best Practices)

Mindig ellenőrizze a statusCode mezőt a hibakategória meghatározásához.
401-es hibáknál ellenőrizze az API-kulcsot, az időbélyeg frissességét (5 percen belül), a nonce egyediségét és az aláírás kiszámítását.
409-es hibáknál megrendelés létrehozásakor az eredeti megrendelés már feldolgozásra került. Kérje le az idempotencia-kulcs vagy külső hivatkozás segítségével.
500-as hibáknál próbálja újra exponenciális visszalépéssel. Ha a hiba fennáll, forduljon az ügyfélszolgálathoz.