API request / response

自社 Agent、社内ワークフロー、推薦候補確認、カレンダー連携から AI Jinzai を呼び出すための REST API です。 AI が必要に応じて参照するための request / response 集です。接続設定は APIキー発行ページから進めてください。

AI参照用社内システムやワークフローへ AI Jinzai を組み込みたいチームAPIキーを発行して接続 OpenAPI を見る

Setup

curl https://api.ai-jinzai.work/v1/me -H "Authorization: Bearer $AI_JINZAI_TOKEN"

認証は `/connect` で発行した PAT を `AI_JINZAI_TOKEN` として使います。AI にはこのページの該当ブロックだけを参照させます。

Reference

発注企業向け Request / Response

依頼作成、推薦候補確認、AI Jinzai への返信、面談候補提示で使う参照例です。

案件情報を API で登録する

ATS や社内 Agent から案件を送るとき

Request

POST /v1/employer/jds
Authorization: Bearer $AI_JINZAI_TOKEN
Content-Type: application/json

{
  "title": "生成 AI 機能の本番化リード",
  "raw_text": "既存 SaaS に RAG と評価基盤を入れたい。週3日、3ヶ月、リモート中心。",
  "engagement_type": "business_consignment",
  "budget_monthly_jpy": 1200000
}

Response

{
  "jd_id": "jd_20260601_001",
  "status": "received",
  "structure_status": "queued",
  "next": "人材会社 Agent が要件確認後、候補者紹介へ進みます"
}

チャットで人材会社 Agent に追加質問を送る

紹介候補者について確認したいことが出たとき

Request

POST /v1/shared/chat/threads/th_123/messages
Authorization: Bearer $AI_JINZAI_TOKEN
Content-Type: application/json

{
  "message": "候補者の RAG 評価基盤の実装経験について、規模と担当範囲を確認してください。"
}

Response

{
  "message_id": "msg_456",
  "thread_id": "th_123",
  "status": "sent",
  "recipient": "agency_agent",
  "direct_candidate_contact": false
}

依頼内容の構造化結果を取得する

AI が依頼作成後に不足条件を確認したいとき

Request

GET /v1/employer/jds/jd_20260601_001
Authorization: Bearer $AI_JINZAI_TOKEN

Response

{
  "jd_id": "jd_20260601_001",
  "status": "structured",
  "must_have": ["Next.js", "Python", "LLM API"],
  "nice_to_have": ["RAG 評価", "LLMOps"],
  "missing_fields": []
}

紹介候補者を一覧取得する

紹介メールに複数候補が含まれていたとき

Request

GET /v1/employer/jds/jd_20260601_001/candidates?status=introduced
Authorization: Bearer $AI_JINZAI_TOKEN

Response

{
  "items": [
    { "candidate_id": "cand_8f7e6d", "fit_summary": "RAG 評価と LLMOps が近い", "next_action": "interview" },
    { "candidate_id": "cand_4c3b2a", "fit_summary": "Next.js は強いが Python 実務が薄い", "next_action": "question" }
  ]
}

本面談候補日を返す

候補者側が興味ありになり、日程調整依頼が届いたとき

Request

POST /v1/employer/interviews/slots
Authorization: Bearer $AI_JINZAI_TOKEN
Content-Type: application/json

{
  "candidate_id": "cand_8f7e6d",
  "job_id": "jd_20260601_001",
  "slots": ["2026-06-04T10:00:00+09:00", "2026-06-05T15:00:00+09:00"]
}

Response

{
  "status": "slots_sent",
  "meeting_type": "final_60min",
  "next": "人材会社 Agent が候補者側と確定します"
}

契約開始準備を確認する

本面談後、合意済み案件の開始準備を見るとき

Request

GET /v1/employer/engagements/eng_20260610_001
Authorization: Bearer $AI_JINZAI_TOKEN

Response

{
  "engagement_id": "eng_20260610_001",
  "status": "contract_in_progress",
  "contract_status": "sent",
  "start_guide_status": "pending"
}