API v1
API per Sviluppatori
Integra JobFlow nei tuoi sistemi con la nostra API REST. Autenticazione via token Bearer (Laravel Sanctum).
Autenticazione
Registra un account, effettua il login per ottenere un token Bearer, e includi il token in ogni richiesta autenticata.
POST /api/v1/auth/register
POST /api/v1/auth/login
POST /api/v1/auth/logout (auth required)
GET /api/v1/auth/me (auth required)
POST /api/v1/auth/login
POST /api/v1/auth/logout (auth required)
GET /api/v1/auth/me (auth required)
Il token va incluso nell'header: Authorization: Bearer {token}
Annunci di Lavoro
Cerca annunci per categoria, posizione geografica e raggio. Candidati direttamente via API.
GET /api/v1/jobs ?category=&location=&radius=&page=
GET /api/v1/jobs/{slug}
GET /api/v1/categories
POST /api/v1/jobs/{id}/apply (auth required)
GET /api/v1/jobs/{slug}
GET /api/v1/categories
POST /api/v1/jobs/{id}/apply (auth required)
Candidature
Gestisci le candidature: visualizza lo stato, aggiorna (aziende) o ritira (lavoratori).
GET /api/v1/applications (auth required)
GET /api/v1/applications/{id} (auth required)
PUT /api/v1/applications/{id}/status (company only)
POST /api/v1/applications/{id}/withdraw (worker only)
GET /api/v1/applications/{id} (auth required)
PUT /api/v1/applications/{id}/status (company only)
POST /api/v1/applications/{id}/withdraw (worker only)
Profili
Leggi e aggiorna il profilo lavoratore o azienda. Accedi al trust score.
GET /api/v1/profile/worker (auth required)
PUT /api/v1/profile/worker (auth required)
GET /api/v1/profile/company (auth required)
PUT /api/v1/profile/company (auth required)
GET /api/v1/profile/trust-score (auth required)
PUT /api/v1/profile/worker (auth required)
GET /api/v1/profile/company (auth required)
PUT /api/v1/profile/company (auth required)
GET /api/v1/profile/trust-score (auth required)
Esempio di utilizzo
# Login
curl -X POST https://jobflow.trovido.com/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"user@example.com","password":"secret"}'
# Response
{"token":"1|abc...","user":{...}}
# List jobs (with token)
curl https://jobflow.trovido.com/api/v1/jobs?category=chef&page=1 \
-H "Authorization: Bearer 1|abc..."
Note importanti
- Rate limit: 60 richieste/minuto per utente autenticato, 30/minuto per utenti anonimi.
- Tutte le risposte sono in formato JSON. Content-Type: application/json.
- Le liste supportano paginazione: ?page=1&per_page=15 (max 100).
- Errori restituiti con codice HTTP appropriato (401, 403, 404, 422, 429) e body JSON con campo "message".
- L'accesso API è disponibile per i piani Business e Premium. Il piano Starter ha accesso in sola lettura agli annunci pubblici.
