> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/hu/partner-api-overview/error-handling.md). # Hibakezelés Epsilon Retail Media A Partner API-k strukturált és konzisztens hibakezelési megközelítést követnek. Ez biztosítja, hogy a hibaválaszok kiszámíthatók, könnyen értelmezhetők és hasznosak legyenek a hibaelhárításhoz. ## Hibaválasz felépítése Hiba esetén az API a következőket adja vissza: * Egy szabványos HTTP-státuszkódot. * Egy strukturált JSON-testet code, message és opcionális details mezővel. * Mezőszintű szabálysértések listáját (adott esetben), ami lehetővé teszi az ügyfelek számára több probléma egyszerre történő javítását. ## Alapvető stratégiák a hibák kezelésére Ha hibába ütközik, kövesse az alábbi lépéseket: 1. **Olvassa el figyelmesen a hibaüzenetet** - A hibaválasz konkrét információkat ad arról, hogy mi romlott el, és melyik mező okozta a problémát. 2. **Tekintse át a végpont oldalát** - Ha nem biztos a folytatásban, tekintse át a használt végpont konkrét oldalát. 3. **Lépjen kapcsolatba a támogatással** - Ha továbbra is problémákat tapasztal, jegyet nyithat a Support Portal felületünkön. Kérjük, adja meg a következőket: * A pontos API-hívást, amelyet végrehajt. * A konkrét kereskedőt és csapatot. * A konkrét entitást, amelyet létrehoz/frissít. * A teljes hibaválaszt, amelyet lát. Ezek az információk biztosítják, hogy csapatunk hatékonyan és eredményesen tudjon segíteni Önnek. ### Példa egyetlen szabálysértésre ```json { "code": 3, "message": "Invalid argument(s) for product campaign creation", "details": [ { "@type": "type.googleapis.com/google.rpc.BadRequest", "fieldViolations": [ { "field": "maxBid", "description": "[maxBid] must be greater or equal [minBid]" } ] } ] } ``` ### Példa több szabálysértésre ```json { "code": 3, "message": "Invalid argument(s) for product campaign update", "details": [ { "@type": "type.googleapis.com/google.rpc.BadRequest", "fieldViolations": [ { "field": "strategy.fixedTenancy.catalogCosts", "description": "all catalog cost percentages for fixed tenancy must sum to 100%" }, { "field": "strategy.fixedTenancy.catalogCosts", "description": "fixed tenancy catalog cost [...] is duplicated in the list" } ] } ] } ``` ## Szabványos HTTP-státuszkódok | HTTP Status Code | Jelentés | Mikor fordul elő | | ------------------------- | ------------------------------------ | --------------------------------------------------------- | | 200 OK | A kérés sikeres volt | Sikeres API-hívás | | 204 No Content | Siker, nincs választest | Sikeres kérés visszatérési adatok nélkül | | 400 Bad Request | Érvénytelen bemenet | Hibásan formázott kérés vagy érvényesítési hiba | | 401 Unauthorized | Hiányzó vagy érvénytelen token | Nincs megadva token, vagy lejárt | | 403 Forbidden | Hozzáférés megtagadva | A token érvényes, de hiányzik a jogosultság | | 404 Not Found | Erőforrás nem található | Érvénytelen végpont vagy erőforrás-ID | | 409 Conflict | Duplikált vagy ellentmondásos adatok | Az erőforrás már létezik, vagy megsérti a megkötéseket | | 429 Too Many Requests | Kérési korlát túllépve | Túl sok kérés rövid időn belül | | 500 Internal Server Error | Szerveroldali probléma | Váratlan hiba a szerveren | | 503 Service Unavailable | Időleges kimaradás | A szolgáltatás nem érhető el, vagy karbantartás alatt áll | ## gRPC–HTTP hibakód-leképezés | gRPC Code | gRPC Name | HTTP Code | HTTP Name | | --------- | -------------------- | --------- | --------------------- | | 0 | OK | 200 | OK | | 1 | CANCELLED | 499 | Client Closed Request | | 2 | UNKNOWN | 500 | Internal Server Error | | 3 | INVALID\_ARGUMENT | 400 | Bad Request | | 4 | DEADLINE\_EXCEEDED | 504 | Gateway Timeout | | 5 | NOT\_FOUND | 404 | Not Found | | 6 | ALREADY\_EXISTS | 409 | Conflict | | 7 | PERMISSION\_DENIED | 403 | Forbidden | | 8 | RESOURCE\_EXHAUSTED | 429 | Too Many Requests | | 9 | FAILED\_PRECONDITION | 400 | Bad Request | | 10 | ABORTED | 409 | Conflict | | 11 | OUT\_OF\_RANGE | 400 | Bad Request | | 12 | UNIMPLEMENTED | 501 | Not Implemented | | 13 | INTERNAL | 500 | Internal Server Error | | 14 | UNAVAILABLE | 503 | Service Unavailable | | 15 | DATA\_LOSS | 500 | Internal Server Error | | 16 | UNAUTHENTICATED | 401 | Unauthorized | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.citrusad.com/retail-media-interface/partner/hu/partner-api-overview/error-handling.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.