API v1
API für Entwickler
Integrieren Sie JobFlow in Ihre Systeme mit unserer REST-API. Authentifizierung über Bearer-Token (Laravel Sanctum).
Authentifizierung
Erstellen Sie ein Konto, melden Sie sich an, um ein Bearer-Token zu erhalten, und fügen Sie es in jede authentifizierte Anfrage ein.
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)
Das Token muss im Header enthalten sein: Authorization: Bearer {token}
Stellenanzeigen
Suchen Sie Anzeigen nach Kategorie, geografischer Position und Radius. Bewerben Sie sich direkt über die 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)
Bewerbungen
Verwalten Sie Bewerbungen: Status einsehen, aktualisieren (Unternehmen) oder zurückziehen (Arbeitnehmer).
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)
Profile
Lesen und aktualisieren Sie das Arbeitnehmer- oder Unternehmensprofil. Zugriff auf den 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)
Verwendungsbeispiel
# 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..."
Wichtige Hinweise
- Rate-Limit: 60 Anfragen/Minute für authentifizierte Benutzer, 30/Minute für anonyme.
- Alle Antworten sind im JSON-Format. Content-Type: application/json.
- Listen unterstützen Paginierung: ?page=1&per_page=15 (max 100).
- Fehler werden mit dem entsprechenden HTTP-Code (401, 403, 404, 422, 429) und JSON-Body mit Feld "message" zurückgegeben.
- Der API-Zugang ist für Business- und Premium-Pläne verfügbar. Der Starter-Plan hat nur Lesezugriff auf öffentliche Anzeigen.
