API referenca

Ova sekcija sadrži API dokumentaciju za integraciju sa AnyBiz platformom.

Pregled

AnyBiz pruža RESTful API izgrađen na oRPC-u (RPC kompatibilan sa OpenAPI standardom). API podržava:

• Autentifikaciju — autentifikacija zasnovana na sesiji preko Better Auth-a
• Kontekst organizacije — svi API pozivi se izvršavaju u kontekstu organizacije
• Tipski bezbedne ugovore — puna TypeScript podrška sa Valibot validacijom

API kategorije

Autentifikacija

• Prijava/odjava
• Registracija
• Upravljanje sesijama

Organizacija

• Upravljanje organizacijom
• Upravljanje članovima
• Upravljanje pretplatom

Funkcionalnosti

• Kasa (POS)
• Fakture (lista, pregled, kreiranje, finalizacija, slanje na eFakturu)
• Poslovni partneri
• Podešavanja (organizacija, eFaktura, fiskalizacija)
• Events SDK (/api/events/sdk/*) za ugradnju mape sedenja i checkout tok na eksternim sajtovima — pogledajte vodič za TicketMap SDK integraciju
• Interno: POST /api/internal/sef-subscribe (cron; zahteva X-Cron-Secret ili Authorization: Bearer sa SEF_CRON_SECRET)

Prvi koraci

Da biste koristili AnyBiz API:

1. Autentifikujte se — prijavite se i dobijte sesiju
2. Izaberite organizaciju — postavite aktivni kontekst organizacije
3. Pozivajte API — koristite dokumentovane endpointe

OpenAPI specifikacija

Kompletna OpenAPI specifikacija se generiše iz oRPC ugovora. Za regeneraciju pokrenite pnpm docs:generate-api iz repozitorijuma.

Osnovni URL

https://api.anybiz.com/api

Za lokalni razvoj:

http://localhost:3000/api

Autentifikacija

Svi API zahtevi zahtevaju autentifikaciju. Uključite kolačić sesije u zahteve:

curl -X GET "https://api.anybiz.com/api/organization/current" \
  -H "Cookie: session=your-session-token"

Ograničenje broja zahteva

API pozivi podležu ograničenju broja zahteva (rate limiting). Pobrinite se da vaša integracija ispravno obrađuje odgovore o prekoračenju limita.

Obrada grešaka

Sve API greške prate isti format:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Čitljiva poruka o grešci"
  }
}

Uobičajeni kodovi grešaka:

• UNAUTHORIZED — potrebna je autentifikacija
• FORBIDDEN — nedovoljne dozvole
• NOT_FOUND — resurs nije pronađen
• VALIDATION_ERROR — nevažeći podaci u zahtevu