Gabimet dhe kufijtë

Gabimet ndjekin RFC 7807: type, title, status, detail dhe një kod të qëndrueshëm. Kufiri është 100 kërkesa në minutë për çdo çelës, i raportuar në kokat e kufirit.

• 400 — trupi i kërkesës nuk u lexua dot
• 401 — çelës që mungon ose i revokuar
• 403 — çelësit i mungon fushëveprimi për këtë thirrje
• 404 — nuk ka kartë, klient apo shpërblim të tillë në këtë biznes
• 409 — çelësi i idempotencës u përdor me një trup tjetër
• 422 — një rregull programi e refuzoi shkrimin, për shembull pritja mes vulave
• 429 — mbi kufirin; riprovo kur ta thotë koka

Kode të qëndrueshme që ia vlen t’i trajtosh nga ana jote:

• customer_blocked — biznesi e ka bllokuar këtë klient: pa karta të reja, pa skanime
• test_mode_live_card — një çelës sk_test_ provoi të ndryshojë një kartë reale; përdor çelës live
• business_suspended — biznesi është pezulluar; API përgjigjet 403 derisa të rikthehet
• insufficient_units — një përdorim parapagimi kërkoi më shumë njësi se sa ka karta
• insufficient_balance — një anulim ose shpërblim do ta çonte bilancin nën zero

Një numër ka një kartë për program. Klienti që heq kartën dhe bashkohet sërish e merr po atë kartë, me bilancin dhe historikun; kuponi i përdorur mbetet i përdorur.

Shembull

curl https://perfito.al/v1/cards/PF-8F2A-19 \
  -H "Authorization: Bearer sk_test_…"

$ch = curl_init('https://perfito.al/v1/cards/PF-8F2A-19');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $key, 'Content-Type: application/json'],
]);
$data = json_decode(curl_exec($ch), true);

const res = await fetch('https://perfito.al/v1/cards/PF-8F2A-19', {
  method: 'GET',
  headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
});
const data = await res.json();