将 NEX 集成到您的工具中

1. 企业账户的所有者打开“企业管理”，再进入“API 与集成”。
2. 创建一个密钥，为其命名，并只勾选所需的权限。
3. 复制仅显示一次的密钥，并保存在将调用 API 的工具中。

创建密钥需要包含 API 访问权限的套餐。已发布的职位无需密钥即可读取。

在每个请求的 Authorization 请求头中发送密钥，放在 Bearer 一词之后。

Authorization: Bearer nex_live_…

密钥可访问贵公司的数据：请将其保存在您的服务器上，切勿放在网页或已安装的应用中。私有接口本身也会拒绝来自浏览器的调用。如有疑问，请撤销并重新创建一个。

每个密钥只能执行创建时勾选的操作。

每个密钥每分钟最多可发送 120 个请求。

无需密钥的公开接口，每个 IP 地址每分钟最多接受 120 个请求。

超出限制时，响应状态码为 429，并带有 Retry-After 请求头，说明需要等待的秒数。

列表接口接受 page（从 1 开始）和 pageSize（默认 20，最多 50）参数，并返回总数和总页数。

{
  "data": [ … ],
  "pagination": { "page": 1, "pageSize": 20, "total": 57, "totalPages": 3 }
}

所有错误的格式都相同：一个稳定的错误代码，供您的程序使用，以及一条英文帮助信息。

{
  "error": {
    "code": "insufficient_scope",
    "message": "This key lacks the \"jobs:write\" scope."
  }
}

• GET/jobs

  列出已发布的职位，最新的排在最前。筛选参数：q（自由文本）、country（ISO 国家代码）、sector（行业代码）、contract（合同类型）。

  公开，无需密钥。

  curl "https://nexjobs.net/api/v1/jobs?q=engineer&pageSize=10"

• GET/jobs/{id}

  已发布职位的详情：职位描述、所需材料，以及职位页面链接（求职者在该页面申请）。

  公开，无需密钥。

  curl "https://nexjobs.net/api/v1/jobs/<id>"

• GET/employer/jobs

  列出贵公司的全部职位（不论状态）及申请数量。筛选参数：status。

  所需权限：jobs:read

  curl "https://nexjobs.net/api/v1/employer/jobs?status=PUBLISHED" \
    -H "Authorization: Bearer nex_live_…"

• POST/employer/jobs

  创建职位：默认保存为草稿；若 publish 为 true，企业已通过验证时立即发布，否则等待审核。

  所需权限：jobs:write

  curl -X POST "https://nexjobs.net/api/v1/employer/jobs" \
    -H "Authorization: Bearer nex_live_…" \
    -H "Content-Type: application/json" \
    -d '{
      "title": "Maintenance technician",
      "description": "Preventive and corrective maintenance of the plant equipment.",
      "contractType": "PERMANENT",
      "payPeriod": "MONTHLY",
      "currency": "USD",
      "salaryMin": 900,
      "salaryMax": 1200,
      "requiredDocuments": [{ "kind": "CV" }],
      "publish": true
    }'

• GET/employer/jobs/{id}

  贵公司某个职位的详情，包括招聘流程的各个阶段及每个阶段的申请数量。

  所需权限：jobs:read

  curl "https://nexjobs.net/api/v1/employer/jobs/<id>" \
    -H "Authorization: Bearer nex_live_…"

• PATCH/employer/jobs/{id}

  关闭已发布或待审核的职位。仅接受变更为“已关闭”状态。

  所需权限：jobs:write

  curl -X PATCH "https://nexjobs.net/api/v1/employer/jobs/<id>" \
    -H "Authorization: Bearer nex_live_…" \
    -H "Content-Type: application/json" \
    -d '{ "status": "CLOSED" }'

• GET/employer/applications

  列出收到的申请。筛选参数：jobId、outcome、updatedSince（ISO 8601 日期）。

  所需权限：applications:read

  curl "https://nexjobs.net/api/v1/employer/applications?outcome=ACTIVE&updatedSince=2026-09-01T00:00:00Z" \
    -H "Authorization: Bearer nex_live_…"

• GET/organization

  返回组织架构：各个管理层、部门、科室和工作岗位。

  所需权限：organization:read

  curl "https://nexjobs.net/api/v1/organization" \
    -H "Authorization: Bearer nex_live_…"

API 绝不会返回候选人的电子邮箱、电话或消息，也不会返回任何密码或账户信息。雇主与候选人之间的联系由 NEX 负责安排。

在 v1 版本中，只会新增字段，绝不会重命名或删除字段。不兼容的变更将以 v2 版本发布，并提前公告。

OpenAPI 规范（JSON）