API v1
API pour Développeurs
Intégrez JobFlow dans vos systèmes avec notre API REST. Authentification par token Bearer (Laravel Sanctum).
Authentification
Créez un compte, connectez-vous pour obtenir un token Bearer et incluez-le dans chaque requête authentifiée.
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)
Le token doit être inclus dans le header : Authorization: Bearer {token}
Annonces d'Emploi
Recherchez des annonces par catégorie, position géographique et rayon. Postulez directement via l'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)
Candidatures
Gérez les candidatures : consultez le statut, mettez à jour (entreprises) ou retirez (travailleurs).
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)
Profils
Lisez et mettez à jour le profil travailleur ou entreprise. Accédez au 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)
Exemple d'utilisation
# 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..."
Notes importantes
- Rate limit : 60 requêtes/minute pour les utilisateurs authentifiés, 30/minute pour les anonymes.
- Toutes les réponses sont au format JSON. Content-Type: application/json.
- Les listes supportent la pagination : ?page=1&per_page=15 (max 100).
- Erreurs renvoyées avec le code HTTP approprié (401, 403, 404, 422, 429) et un body JSON avec le champ "message".
- L'accès API est disponible pour les plans Business et Premium. Le plan Starter a un accès en lecture seule aux annonces publiques.
