调用价格
30 匠币/次
快速接入
保持统一返回结构,直接通过服务端发起请求即可接入。
https://openapi.toolkk.com/v1/resume-parsercURL 示例
curl --request POST \
--url 'https://openapi.toolkk.com/v1/resume-parser' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "fileBase64": "<base64>",\n "fileName": "resume.pdf"\n}'Python 示例
import os
import requests
url = "https://openapi.toolkk.com/v1/resume-parser"
payload = {
"fileBase64": "<base64>",
"fileName": "resume.pdf"
}
headers = {
"Content-Type": "application/json",
"X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}
response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())Go 示例
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/resume-parser"
payload := []byte("{\n \"fileBase64\": \"<base64>\",\n \"fileName\": \"resume.pdf\"\n}")
req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(string(body))
}Java 示例
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ToolkkExample {
public static void main(String[] args) throws Exception {
String payload = "{\n \"fileBase64\": \"<base64>\",\n \"fileName\": \"resume.pdf\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/resume-parser"))
.method("POST", HttpRequest.BodyPublishers.ofString(payload))
.header("Content-Type", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}PHP 示例
<?php
$endpoint = 'https://openapi.toolkk.com/v1/resume-parser';
$payload = "{\n \"fileBase64\": \"<base64>\",\n \"fileName\": \"resume.pdf\"\n}";
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-API-Key: YOUR_API_KEY',
],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
echo $response;响应示例
{
"code": "SUCCESS",
"data": {
"name": "John Doe",
"email": "john@example.com",
"skills": [],
"education": [],
"experience": []
}
}示例用于理解返回结构,实际结果以接口返回为准。
- 鉴权方式
- 请求头传入 X-API-Key
- 默认限流
- 30 次/分钟
- 超时时间
- 30000 ms
服务端调用时,将 API Key 放在 X-API-Key 请求头中。
建议按 response code 与业务字段双重判断调用结果。
高频调用场景请结合速率限制与重试策略使用。
请求字段
从服务端发起请求,并在 X-API-Key 请求头中传入密钥。
请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| fileBase64 | string | 未标注 | 未标注 | <base64> |
| fileName | string | 未标注 | 未标注 | resume.pdf |
请求示例
{
"fileBase64": "<base64>",
"fileName": "resume.pdf"
}- 鉴权方式
- 请求头传入 X-API-Key
- 默认限流
- 30 次/分钟
- 超时时间
- 30000 ms
响应字段
示例用于理解返回结构,实际结果以接口返回为准。
响应字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| code | string | 未标注 | 未标注 | SUCCESS |
| data | object | 未标注 | 未标注 | {...} |
| data.name | string | 未标注 | 未标注 | John Doe |
| data.email | string | 未标注 | 未标注 | john@example.com |
| data.skills | array | 未标注 | 未标注 | [] |
| data.education | array | 未标注 | 未标注 | [] |
| data.experience | array | 未标注 | 未标注 | [] |
响应示例
{
"code": "SUCCESS",
"data": {
"name": "John Doe",
"email": "john@example.com",
"skills": [],
"education": [],
"experience": []
}
}接口简介
接口能力、应用场景、使用限制与常见问题。
把简历文件变成可用的候选人资料
英文简历解析 API 接收 PDF、DOC 或 DOCX 简历,提取姓名、邮箱、技能、教育经历和工作经历,返回便于程序读取的 JSON。它适合把文档接入业务系统,减少人工逐项录入;解析结果仍应与原简历核对。英文是该服务验证最充分的语言,其他语言的效果需要用实际样本评估。
适合接入哪些业务流程
- 招聘系统:候选人提交简历后,用提取结果预填资料表单,让候选人或招聘人员确认后保存。
- 人才库整理:把获授权的历史简历转成统一记录,便于按技能、教育或工作经历建立检索条件。
- 招聘运营:将解析结果交给自己的去重、标签和分配流程。岗位匹配、打分和录用判断需要另外实现,接口本身不提供这些结论。
如何提交文件和处理返回结果
先准备一份可阅读的简历,把文件内容编码为 fileBase64,并通过 fileName 保留真实文件名及扩展名,再从后端调用接口。具体请求示例与鉴权方式见“快速接入”和“请求字段”。
成功后读取 data 中的 name、email、skills、education 和 experience。技能与经历按实际返回的数组处理,不要只取第一项;某项为空时应保留“待核对”状态,不能把未提取到的内容当作候选人没有相关经历。
解析边界与资料处理
模型提取可能漏项或误识别,复杂排版、扫描件和图片文字应先做样本验证,不宜承诺与文本型文档相同的效果。文件能够打开也不代表所有字段都会被识别。
简历会交给上游服务处理。接入时应取得资料处理授权,控制原文件与解析结果的访问权限,并按业务目的设置留存期限。正式上线前,建议用脱敏样本检查字段完整度,把需人工补录的情况纳入流程。