API dokumentacija

Integrirajte svoje sustave s FireCustos-om koristeći naš REST API. Sinkronizirajte podatke o osoblju, masovno uvozite zapise vatrogasaca i izgradite prilagođene integracije.

Brzi početak #

Napravite svoj prvi API poziv u tri koraka.

1. Kreirajte API ključ

   Idite na Postavke → API ključevi u FireCustos administratorskom panelu i kreirajte novi API ključ. Kopirajte ključ — prikazuje se samo jednom.

2. Napravite prvi zahtjev

   Koristite API ključ za popis vatrogasaca u vašem odjelu:

   bash

   Kopiraj

   curl -X GET https://app.firecustos.com/api/v1/firefighters \
     -H "Authorization: Bearer fc_your_api_key_here"

3. Pogledajte odgovor

   API vraća JSON s paginiranim rezultatima:

   json

   Kopiraj

   {
     "data": {
       "items": [
         {
           "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
           "firstName": "Ivan",
           "lastName": "Horvat",
           "phoneNumber": "+385 91 234 5678",
           "email": "ivan.horvat@example.com",
           "dateOfBirth": "1990-05-15T00:00:00Z",
           "invitationStatus": null,
           "userId": null
         }
       ],
       "page": 1,
       "pageSize": 20,
       "totalCount": 1,
       "totalPages": 1,
       "hasPreviousPage": false,
       "hasNextPage": false
     },
     "totalCount": 1
   }

Bazni URL #

Svi API endpointi se poslužuju s:

https://app.firecustos.com/api/v1/

Konvencije #

Sva tijela zahtjeva i odgovora koriste JSON. Postavite Content-Type zaglavlje na application/json za zahtjeve s tijelom. Datumi su u ISO 8601 formatu (npr. 2024-01-15T00:00:00Z). Svi ID-evi su UUID-ovi.