いま使っているシステムの中に、検証済みのアセスメントを。

接続方法は4通り、手間の少ない順に。

連携すると、実際に何が手に入るのか。

6つのエンドポイントで完結する API。

ベース URL は https://hirovia.com/api/v1。認証は 設定 → API で発行するベアラートークンを使います。hv_test_ で始まるキーはサンドボックス、hv_live_ は本番で、プランの利用量に計上されます。レート制限はキーあたり毎分120リクエストです。

候補者を作成する

curl -X POST https://hirovia.com/api/v1/candidates \
  -H "Authorization: Bearer hv_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Doe",
    "email": "jane@example.com",
    "role": "cam",
    "send_email": true
  }'

{
  "id": 412,
  "name": "Jane Doe",
  "role": "cam",
  "role_title": "Corporate Accounts Manager",
  "status": "invited",
  "test": true,
  "assessment_url": "https://hirovia.com/a/xJ2f8Kq1",
  "invitation_emailed": false
}

assessment_url をご自身で候補者に送っても、send_email を指定して Hirovia から御社名義でメールを送っても構いません。

結果を読む

curl https://hirovia.com/api/v1/candidates/412 \
  -H "Authorization: Bearer hv_test_..."

{
  "id": 412,
  "status": "completed",
  "completed_at": "2026-08-19T10:41:00Z",
  "scores": {
    "composite": 89,
    "role_fit": 90,
    "band": "Exceptional",
    "scenarios_pct": 78,
    "validity_flags": []
  }
}

composite は 0〜100 のランキング数値です。band は職種適合度を平易な言葉で表したものです。validity_flags が空でない場合、回答が雑か作為的であることを示します — スコアの高さにかかわらず、そのプロファイルは疑って扱ってください。

実在の候補者なしで一連の流れをテストする

curl -X POST https://hirovia.com/api/v1/candidates/412/simulate \
  -H "Authorization: Bearer hv_test_..." \
  -H "Content-Type: application/json" \
  -d '{"band": "weak"}'

レポート構造を含む、完全な形の完了済み候補者が返ります。結果処理の実装とテストを数分で終えられます。"band": "weak" を渡せば、フラグ付きで低スコアのプロファイルが返るため、異常系も確認できます。

{ "error": { "message": "unknown role 'manager' - call GET /api/v1/roles for valid ids",
             "status": 400 } }

API 経由の候補者も、課金は他の候補者とまったく同じです。