Aixunren Open API

API开发文档

独立开发者文档页。接口按业务对象完整展开，直接查看路径、用途、关键字段和调用示例，不再做成分散卡片。

查看接口大列表返回帮助中心
POST /v1/interviews
Authorization: Bearer $AIXUNREN_API_KEY
Content-Type: application/json

{
  "job_id": "job_123",
  "candidate_id": "cand_456",
  "mode": "ai_video"
}

接口大列表

点开 API开发文档 后进入这一页，主要接口全部展开显示，方便开发直接查路径、字段和调用方式。

职位与需求

围绕岗位创建、需求同步、预算周期和交付节点管理。

Jobs API
POST

创建职位需求

创建新的招聘需求，写入岗位名称、城市、预算、招聘要求和交付周期。

/v1/jobs
titlelocationrequirementsbudget
GET

查询职位详情

读取职位详情、当前状态、候选人漏斗和交付进度。

/v1/jobs/{job_id}
job_idstatuspipeline
PATCH

更新招聘需求

调整岗位要求、薪资预算、优先级或关闭职位。

/v1/jobs/{job_id}
prioritysalaryclosed

候选人资料

候选人画像、简历、来源、沟通记录和状态流转。

Candidates API
POST

创建候选人

导入候选人基础信息、简历文本或简历文件地址。

/v1/candidates
nameresume_urlsource
GET

查询候选人画像

读取解析后的简历、工作经历、技能标签和沟通历史。

/v1/candidates/{candidate_id}
profileresumetimeline
PATCH

更新候选人状态

同步候选人在招聘流程中的阶段变化。

/v1/candidates/{candidate_id}/stage
stagereasonoperator

AI 面试

创建视频、语音或对话式面试任务，查询记录和结果。

Interviews API
POST

创建 AI 面试

为指定候选人创建视频、语音或对话式面试。

/v1/interviews
job_idcandidate_idmode
GET

查询面试结果

读取面试状态、转写内容、问题记录和综合结论。

/v1/interviews/{interview_id}
statustranscriptsummary

评分与报告

统一输出评分卡、能力维度、风险提示和推荐结论。

Scorecards API
POST

生成评分报告

基于简历、面试、岗位要求生成结构化评分卡。

/v1/scorecards
candidate_idjob_iddimensions
GET

读取评分报告

读取综合得分、分项解释、优势短板和面试建议。

/v1/scorecards/{scorecard_id}
scoreriskrecommendation

Webhook 回调

候选人状态、面试完成、评分生成和交付节点实时推送。

Webhooks
EVENT

interview.completed

AI 面试完成后推送候选人、面试任务和结果摘要。

POST {your_webhook_url}
interview_idcandidate_idresult
EVENT

scorecard.created

评分报告生成后推送报告 ID 和查看地址。

POST {your_webhook_url}
scorecard_idscoreurl
EVENT

candidate.updated

候选人阶段、沟通记录或状态变化时实时通知。

POST {your_webhook_url}
candidate_idstageupdated_at
调用示例cURL
curl -X POST https://api.aixunren.com/v1/jobs \
  -H "Authorization: Bearer $AIXUNREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"AI产品经理","location":"上海"}'

接入说明

测试环境和生产环境密钥分开管理。真实密钥只应保存在服务端，不要暴露在浏览器页面、客户端或公开仓库里。

需要接入 API？

联系我们获取测试密钥、字段说明和联调支持。

联系支持