Kuponi: API - Praktični primjeri

Koristeći cURL CLI alat preko Linux terminala

Za praktičnu probu API poziva je potrebno da prethodno obezbijedite:

• Linux terminal i cURL alat (yum install curl)

• korisnički token za API pozive (kako da dobijem korisnički token?)

• klijentski certifikat u p12 formatu (CA: CoreIT, PoštaCG, Telekom)

U primjerima koristimo vrijednost token123 za korisnički token. Za certifikat koristimo naziv datoteke clientCert.p12 i lozinku qwerty za pristup certifikatu.

Pobrinite se da u istom direktorijumu odakle isprobavate kopirate i datoteku sa certifikatom (p12 datoteka).

Izrada/aktivacija kupona

U nastavku su dati primjeri izrade kupona i aktivacije na račun korisnika. Ukoliko je API poziv uspješan dobija se povratna HTTP poruka 201 Created, a u poruci iz odgovora, u kolonama odvojenim sa praznim prostorom: broj kupona, iznos dopune i hash kod kupona.

123-XXXX-XXX 500 e6537bcaea9d64e0cfaf...

U pozivima koristimo testni i produkcioni režim rada. Testni režim se podrazumjeva, osim ukoliko preko parametra nije posebno isključen - dryRun=false.

Svaki korisnik preko web portala može da očita svoj broj računa - prelaskom na meni opciju "Stanje na računu" iz korisničkog menija. Ukoliko se u API pozivu proslijedi broj korisničkog računa, tada se kupon istovremeno i aktivira na taj korisnički račun.

Primjer 1: Izrada kupona (testno)

Izrađujemo kupon u vrijednosti 5EUR (DOPUNA5) i podrazumjeva se dryRun režim rada.

curl -v -X POST --cert-type P12 --cert clientCert.p12:qwerty \
 -F accountToken=token123 \
 -F couponType=DOPUNA5 \
 https://preko.edostava.me/api/v1.0/coupons

Primjer 2: Izrada kupona (produkciono)

Izrađujemo kupon u vrijednosti 10EUR (DOPUNA10) i uključujemo produkcioni režim rada (dryRun=false).

curl -v -X POST --cert-type P12 --cert clientCert.p12:qwerty \
 -F accountToken=token123 \
 -F couponType=DOPUNA10 \
 -F dryRun=false \
 https://preko.edostava.me/api/v1.0/coupons

Primjer 3: Izrada i aktivacija kupona (testno)

Izrađujemo kupon u vrijednosti 15EUR (DOPUNA15), aktiviramo na korisničkom računu br. 00-2e i podrazumjeva se dryRun režim rada.

curl -v -X POST --cert-type P12 --cert clientCert.p12:qwerty \
 -F accountToken=token123 \
 -F couponType=DOPUNA15 \
 -F redeemTarget=00-e2 \
 https://preko.edostava.me/api/v1.0/coupons

Primjer 4: Izrada i aktivacija kupona (produkciono)

Izrađujemo kupon u vrijednosti 20EUR (DOPUNA20), aktiviramo na korisničkom računu br. 00-2e i uključujemo produkcioni režim rada (dryRun=false).

curl -v -X POST --cert-type P12 --cert clientCert.p12:qwerty \
 -F accountToken=token123 \
 -F couponType=DOPUNA20 \
 -F redeemTarget=00-e2 \
 -F dryRun=false \
 https://preko.edostava.me/api/v1.0/coupons

Poništavanje kupona

Moguće je poništiti samo kupone koji nijesu aktivirani na korisničkom računu. Za poništavanje koda je potrebno da ste u izradi kupona sačuvali dobijeni hash kod kupona.

Primjer 1: Poništavanje kupona (testno)

Poništavamo kupon sa određenim hash kodom, uz proslijeđen razlog poništavanja i podrazumjeva se dryRun režim rada.

curl -v -X PATCH --cert-type P12 --cert clientCert.p12:qwerty \
 -F accountToken=123 \
 -F couponCodeHash=e6537bcaea9d64e0cfaf... \
 -F invalidationReason="Poništeno zbog greške kod korisnika." \
 https://preko.edostava.me/api/v1.0/coupons/invalidate

Primjer 2: Poništavanje kupona (produkciono)

Poništavamo kupon sa određenim hash kodom, bez navedenog razloga poništavanja i uključujemo produkcioni režim rada (dryRun=false).

curl -v -X PATCH --cert-type P12 --cert clientCert.p12:qwerty \
 -F accountToken=123 \
 -F couponCodeHash=e6537bcaea9d64e0cfaf... \
 -F dryRun=false \
 https://preko.edostava.me/api/v1.0/coupons/invalidate