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アクセスはビジネスプランとプレミアムプランで利用可能です。スタータープランは公開求人の閲覧のみ可能です。