đ AllmĂ€nna API-resurser
VÀlkommen till Esadax API-referens. HÀr hittar du all viktig information du behöver för att interagera med vÄrt API, inklusive hur du autentiserar, förstÄr svarstatusar och löser valideringsfel.
Autentisering
Alla API-förfrÄgningar mÄste autentiseras med hjÀlp av en API-token. Detta görs genom att lÀgga till ett Authorization-huvud till din HTTP-förfrÄgan.
â Huvudformat
Authorization: Bearer XXX
ErsÀtt XXX med din faktiska API-token.
Om API-tokens
- API-tokens genereras per anvÀndarkonto.
- Varje token kan ha anpassade behörigheter för att begrÀnsa Ätkomsten till specifika delar av ditt konto.
- Detta hjÀlper till att hÄlla din integration sÀker genom att endast bevilja den Ätkomst som Àr nödvÀndig.
âĄïž LĂ€s mer om att hantera API-tokens
AnvÀndargrÀnssnittssvar
Esadax anvÀnder RESTful principer och överensstÀmmer med standard HTTP svar praxis. Varje svar frÄn API:et innehÄller en relevant HTTP-statuskod som anger om din begÀran lyckades eller misslyckades.
đ HTTP-statuskoder
| Kod | Namn | Beskrivning |
|---|---|---|
| 200 | Okej. | BegÀran accepterades framgÄngsrikt. |
| 201 sid. | Skapad | Resursen har skapats. |
| 202 sid. | GodkÀnd | BegÀran accepterades och bearbetningen fortsÀtter i bakgrunden. |
| 204 sid. | Inget innehÄll hittades | BegÀran godkÀndes, men det finns inget innehÄll att returnera. |
| 400 | DÄlig begÀran | Det uppstod ett fel med din begÀran. Kontrollera slutpunktskraven och försök igen. |
| 401 artiklar | Obehörig | Ogiltig API token. LÀs mer. |
| 403 sid. | Förbjudet | à tgÀrden Àr inte tillÄten för detta token eller konto. Kontrollera tokenbehörigheter. |
| 404 | Sidan hittades inte | Den begÀrda resursen hittades inte. |
| 405 sid. | Metod ej tillÄten | HTTP-metoden som anvÀnds stöds inte för den hÀr slutpunkten. |
| 408 sid. | TidsgrÀns för begÀran | Det blev timeout i vÄr Ànde. VÀnligen kontakta support. |
| 421 sid. | TjÀnsten Àr inte tillgÀnglig | Webbplatsen genomgÄr just nu underhÄll. Försök igen senare. |
| 422 sid. | Entitet som inte kan bearbetas | Valideringsfel i din förfrÄgan. Granska och försök igen. LÀs mer |
| 429 sid. | För mÄnga förfrÄgningar | HastighetsgrÀns överskriden. LÀs mer om hastighetsgrÀnser |
| 500 | Internt serverfel | OvÀntat serverfel. VÀnligen kontakta support. |
| 502 sid. | Ogiltig gateway | TillfÀlligt systemfel. VÀnligen kontakta support. |
| 503 sid. | TjÀnsten Àr inte tillgÀnglig | Webbplatsen Àr för nÀrvarande inte tillgÀnglig. VÀnligen kontakta support. |
| 504 sid. | TidsgrÀns för gateway | Det uppstod en timeout pÄ vÄrt system. VÀnligen kontakta support. |
đ Mer information om HTTP-statuskoder finns pĂ„ Mozilla Developer Network.
SQL-valideringsfel
Valideringsfel (HTTP 422) intrÀffar nÀr nyttolasten för din begÀran inte uppfyller kraven för en viss slutpunkt. Detta kan bero pÄ:
- Saknade obligatoriska fÀlt
- Ogiltiga dataformat
- Felaktiga parametrar
Dubbelkolla alltid API endpoint documentation för att sÀkerstÀlla att din begÀran matchar det förvÀntade formatet.
