JobFlow | 开发者API

认证

注册账户，登录获取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)

令牌应包含在请求头中：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/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/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)

使用示例

# 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消息体。
API访问适用于商业版和高级版计划。入门版仅可读取公开职位。