API v1
API для разработчиков
Интегрируйте JobFlow в свои системы через REST API. Аутентификация через Bearer-токен (Laravel Sanctum).
Аутентификация
Зарегистрируйте аккаунт, войдите для получения Bearer-токена и включайте токен в каждый аутентифицированный запрос.
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)
Токен передаётся в заголовке: Authorization: Bearer {token}
Вакансии
Ищите вакансии по категории, геолокации и радиусу. Откликайтесь напрямую через 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)
Отклики
Управляйте откликами: просматривайте статус, обновляйте (компании) или отзывайте (работники).
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)
Профили
Читайте и обновляйте профиль работника или компании. Доступ к рейтингу доверия.
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)
Пример использования
# 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..."
Важные замечания
- Лимит запросов: 60 запросов/минуту для авторизованных пользователей, 30/минуту для анонимных.
- Все ответы в формате JSON. Content-Type: application/json.
- Списки поддерживают пагинацию: ?page=1&per_page=15 (макс. 100).
- Ошибки возвращаются с соответствующим HTTP-кодом (401, 403, 404, 422, 429) и JSON-телом с полем "message".
- Доступ к API предоставляется для планов Business и Premium. План Starter имеет доступ только для чтения публичных вакансий.
