> For the complete documentation index, see [llms.txt](https://knjiga.edostava.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knjiga.edostava.me/prirucnik/integracija/kuponske-operacije/kuponi-api-prakticni-primjeri.md).

# Kuponi: API - Praktični primjeri

Koristeći cURL CLI alat preko Linux terminala

Za praktičnu probu API poziva je potrebno da prethodno obezbijedite:&#x20;

* [x] Linux terminal i cURL alat (`yum install curl`)
* [x] korisnički token za  [API pozive](https://knjiga.edostava.me/prirucnik/integracija/kuponske-operacije/kuponi-api-specifikacija.md) ([kako da dobijem korisnički token?](https://knjiga.edostava.me/prirucnik/integracija/kako-da-dobijem-korisnicki-token.md))
* [x] 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.&#x20;

{% hint style="info" %}
Pobrinite se da u istom direktorijumu odakle isprobavate kopirate i datoteku sa certifikatom (p12 datoteka).
{% endhint %}

## 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](https://knjiga.edostava.me/prirucnik/servisni-portal/dopuna-racuna/broj-racuna.md) - 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.

```bash
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).

```bash
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.

```bash
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).

```bash
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.

```bash
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).

```bash
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
```
