AI驱动的API

工作描述生成器

创建一个针对各种参数量身定制的详细职位描述。

根据广泛的参数列表，此端点在响应格式中提供简明的工作细节，包括简短描述、工作要求和工作职责。

基于输入参数（如职位名称、公司、教育、经验和所需技能）生成简洁、全面的职位描述。此 API 非常适合创建一致且高质量的职位发布，大大简化了招聘流程。

开发人员可以使用此 API 增强人力资源应用程序、招聘平台或职位板。它简化了职位描述的创建，节省时间并确保准确性。该 API 特别适用于自动化职位发布、与申请人跟踪系统集成以及改进人力资源软件解决方案。

只有 name 参数是必需的。

您可以通过提供 voice_tone 参数来设置首选的写作风格。它可以是形容词，如 funny 或 joyous，甚至是某个 著名作家 的名字。

此 API 方法还提供可选的 context 参数，可用于提供额外的灵活内容处理说明。

AI 工作涉及两个关键步骤：

提交AI任务： 通过发送工作请求来启动流程。
监控和接收结果： 持续检查作业状态，并在成功完成后获取最终输出。

第1步：提交 AI 职位请求

端点： POST - /v1/hr/job_description

参数	类型	必须	描述
name	String	Yes	职位的工作头衔（例如：`Senior PHP Software Engineer`）。
company_name	String	No	提供职位的公司的名称（例如：`Apple Inc`）。
minimum_education	String	No	最低要求的教育水平（例如：`Bachelor Degree`）。
minimum_work_experience	String	No	最低要求的工作经验（例如：`5 years`）。
employment_type	String	No	就业类型（例如：全职、兼职、合同工）。
country	String	No	工作所在国家（例如：`United Kingdom`）。
remote	Boolean	No	指定工作是否为远程（`true` 或 `false`）。
visa_sponsored	Boolean	No	指定是否提供签证赞助（`true` 或 `false`）。
required_skills	Array of Strings	No	职位所需技能列表（例如：`{ "PHP8", "Laravel"}`）。
optional_skills	Array of Strings	No	职位可选技能列表（例如：`{"AWS RDS", "GitFlow"}`）。
language	String	No	职位描述的语言（例如：`English`）。
voice_tone	String	No	描述的语气（例如：`neutral`，`professional`）。
context	String	No	额外的背景或要求（例如：`add requirement of C-class driving license`）。

请求示例：

{
  "name": "Senior PHP Software Engineer",
  "company_name": "Apple Inc",
  "minimum_education": "Bachelor Degree",
  "minimum_work_experience": "5 years",
  "employment_type": "full time",
  "country": "United Kingdom",
  "remote": true,
  "visa_sponsored": true,
  "required_skills": [
    "PHP8",
    "Laravel",
    "MySQL"
  ],
  "optional_skills": [
    "AWS RDS",
    "AWS Aurora",
    "GitFlow"
  ],
  "language": "English",
  "voice_tone": "neutral",
  "context": "add requirement of C-class driving license"
}

响应示例：

{
  "status_url": "https://sharpapi.com/api/v1/content/translate/job/status/5de4887a-0dfd-49b6-8edb-9280e468c210",
  "job_id": "5de4887a-0dfd-49b6-8edb-9280e468c210"
}

第2步：监控并获取 AI 职位结果

结果示例：

{
  "data": {
    "type": "api_job_result",
    "id": "081d6ba5-329d-4723-b88f-a8c88bc3a9cb",
    "attributes": {
      "status": "success",
      "type": "hr_job_description",
      "result": {
        "job_requirements": "- 软件工程经验至少5年\n- 计算机科学或相关领域的学士学位\n- 精通PHP8、Laravel和MySQL\n- 熟悉AWS RDS、AWS Aurora和GitFlow者优先\n- 强大的问题解决能力和注重细节\n- 出色的沟通和团队合作能力\n- C级驾照",
        "job_responsibilities": "- 开发、测试和维护高质量的PHP应用程序\n- 与跨职能团队合作定义和实现新功能\n- 优化应用程序性能和可扩展性\n- 通过代码审查和最佳实践确保代码质量和可维护性\n- 解决软件缺陷和问题\n- 了解最新的行业趋势和技术\n- 指导和引导初级开发人员",
        "job_short_description": "我们正在寻找一位高技能的高级PHP软件工程师加入我们在英国的远程团队。此全职职位要求至少5年的经验和学士学位。理想的候选人将在PHP8、Laravel和MySQL方面具有专业知识，AWS RDS、AWS Aurora和GitFlow的额外技能将是有利的。提供签证赞助。"
      }
    }
  }
}