HTTP kodai

API HTTP kodai klaidų atveju:

Kliento klaidos

  • 400 – Bloga užklausa, netinkami parametrai, verslo logikos klaidos
  • 401 – Tapatybės nustatymas nepavyko arba yra nepakankamas (t.y., kai numatomas 1 lygis, bet reikalautinas 2 lygis)
  • 404 – Išteklius neegzistuoja arba šiai el. parduotuvei yra neprieinamas (priklauso kitai el. parduotuvei)
  • 409 – Ištekliaus konfliktas
  • 415 – Užklausos turinio tipas nėra application/json.

Serverio klaidos

  • 500 – visos serverio vidinės klaidos

Atsako sandara

Kliento klaidos
Esant kliento klaidoms, API atsako su parametru code (kodas) ir message (pranešimas). Pasirinktinis errors (klaidų) rinkinys gali būti grąžintas su daugiau informacijos apie įvykusią klaidą.

PVZ.:

POST /transactions
{
    "code": 1001,
    "message": "Invalid input",
    "errors": [
        {
            "resource": "transaction",
            "field": "currency",
            "type": "invalid"
        },
        {
            "resource": "customer",
            "field": "ip",
            "type": "missing"
        }
    ]

}

 

Serverio klaidos

Serverio klaidos nerodo jokių pranešimų.

 

Verslo logikos klaidos

Visos verslo logikos klaidos yra grąžinamos su 400 HTTP statusu.

Kodas Pranešimas
1001 Netinkama užklausa
1002 Išteklius nerastas
101x Klaidos, susijusios su el. parduotuve arba pardavėju
1011 Parduotuvė neaktyvi
1012 Mokėjimai kortele šiai parduotuvei neįjungti
1013 OCP ir Pasikartojantys mokėjimai parduotuvėje išjungti
102x Klaidos, susijusios su sandoriais
1021 Sandorio statusas klaidingas
103x Klaidos, susijusios su mokėjimais
1031 Mokėjimo statusas klaidingas
1032 Mokėjimo atlikti negalima (sandorio statuso pažeidimas)
1033 Kortelės galiojimo laikas baigėsi
1034 Lėšų nepakanka
1035 Mokėjimas atmestas
1036 Prieiga nepavyko
104x Klaidos, susijusios su mokėjimų grąžinimais
1041 Sandorio statusas neteisingas, grąžinti negalima
1042 Grąžinamosios išmokos suma didesnė nei galima grąžinti
105x Klaidos, susijusios su klientais
106x Klaidos, susijusios su prieigos raktais
1061 Netinkamas sandoris
1062 Sandorio konfliktas
1063 Prieigos rakto sukurti nepavyko
1064 Prieigos raktas nebegalioja
1065 Prieigos rakto statusas neteisingas
1065 Prieigos rakto statusas neteisingas
2003 Įmokos mokėjimas nepavyko
2005 Grąžinamosios išmokos mokėjimas nepavyko