API för Hurra Auto

Ett anrop skickar ett presentkort på sms. Mottagaren väljer kortet själv, och kostnaden dras från ert saldo. Det fungerar från HR-systemet, CRM:et eller allt som kan göra ett HTTP-anrop.

Nyckel

Skapa en API-nyckel i kontot under Hurra Auto. Den visas en gång, så spara den på ett säkert ställe. Skicka den i headern Authorization som Bearer.

Skicka en gåva

POST /api/v1/gavor

curl https://hurra.nu/api/v1/gavor \
  -H "Authorization: Bearer hurra_…" \
  -H "Content-Type: application/json" \
  -d '{
    "regel": "8f0c6b1e-…",
    "namn": "Anna Andersson",
    "mobil": "0701234567",
    "belopp": 300,
    "extern_id": "anst-1042"
  }'

regel: Regelns id. Det står på regeln i kontot under Hurra Auto.
namn: Mottagarens namn, som det ska stå i sms:et.
mobil: Ett svenskt mobilnummer. 070-123 45 67, 0701234567 och +46701234567 går lika bra.
belopp: Valfritt. Hela kronor. Utan belopp gäller regelns.
extern_id: Valfritt men bra. Ert eget id, till exempel anställningsnummer eller kund-id. Samma id ger aldrig två gåvor från samma regel.

Svar

Beloppen är i hela kronor, och saldo är det som är kvar efter gåvan. Kommer samma extern_id igen blir status redan_skickad och svaret gäller den första gåvan.

{
  "ok": true,
  "id": "3d2a…",
  "status": "skickad",
  "belopp": 300,
  "avgift": 49,
  "moms": 12,
  "totalt": 361,
  "saldo": 6420
}

401: Nyckeln saknas, är fel eller har tagits bort.
402: Saldot räcker inte. Fyll på förskottet i kontot.
404: Regeln finns inte hos ert företag.
422: Något fält är fel. Svaret säger vilket i fel.