Početak rada

DEXPIRY HTTP API integracijsko je sučelje za portal trgovca, korisničke aplikacije i admin nadzornu ploču. Interaktivna referenca generira se iz OpenAPI specifikacije; ovaj vodič je kratki put do prvog uspješnog poziva.

Osnovni URL-ovi

Okruženje	URL
Lokalno	`http://localhost:3001`
Produkcija	`https://api.dexpiry.com`

Kad API radi lokalno, Swagger UI dostupan je na http://localhost:3001/docs. Ista specifikacija na ovom portalu je OpenAPI JSON i API referenca.

Uloge

Uloga	Autentikacija	Tipičan posao
Trgovac	JWT e-mail/lozinka (`POST /v1/auth/login`)	Proizvodi, izdavanje jamstava, adrese pošiljatelja
Kupac	JWT s claim ili magic linka	Jamstva, računi, inbox adresa
Admin	JWT s admin ulogom	Trgovci, globalni proizvodi, statistika
Javno	Nema	Health, pretraga globalnih proizvoda, OpenAPI

Sve autentificirane rute očekuju:

Authorization: Bearer <jwt>

Vidi Autentikacija.

Prvi pozivi

Health (bez autentikacije):

curl https://api.dexpiry.com/health

Prijava trgovca:

curl -X POST https://api.dexpiry.com/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "trgovac@example.com", "password": "vasaLozinka"}'

Odgovor sadrži token i user (id, uloga, merchantId kada postoji). Taj token šaljete na sljedeće rute trgovca.

Izdavanje jamstva (JWT trgovca):

curl -X POST https://api.dexpiry.com/v1/merchant/warranties/issue \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "serialNumber": "SN-12345",
    "merchantProductId": "<uuid>",
    "customerEmail": "kupac@example.com"
  }'

Izdavanje se prihvaća asinkrono (202) dok se NFT mint izvršava u pozadini. Kupac zatim otvara claim ili magic link kako bi jamstvo vezao uz svoj novčanik.

OpenAPI

Preuzmite specifikaciju za generatore koda ili AI agente:

curl https://api.dexpiry.com/openapi.json -o openapi.json

Na ovom portalu: OpenAPI specifikacija · API referenca.

Povezana produkcijska dokumentacija

Poglavlja pod Dokumentacija opisuju proizvod (korisnička aplikacija, platforma za trgovce, sloj povjerenja, usluge životnog ciklusa). To je ista dokumentacija v2.0 na hrvatskom i engleskom — uređujte te Markdown datoteke; Word izvornici više nisu živi izvor.