按 plrN 姓名搜索板球运动员,返回球员 ID、所属球队、出生日期和头像图片 ID。
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →按姓名搜索板球运动员。plrN 是唯一的输入且为必填:填写球员姓名或姓名片段文本,文档中的示例是 Tucker。源 200 示例是一个对象,包含重复搜索词的 category 字符串(Tucker)和一个 player 数组。每个球员条目包含 id(字符串,如 11131)、name、teamName(例如 Bermuda、Australia、Ireland、South Africa 或 Scotland)、dob(YYYY-MM-DD 格式的日期字符串,日期未知时为文本 N/A)以及 faceImageId(数字)。示例中 Tucker 共列出八条匹配结果,其中几位只是姓氏相同、效力于不同球队;同一个 faceImageId 182026 还出现在三个互不相关的条目上,因此不要把它当作每个人唯一的标识。源文档没有说明最短搜索长度、匹配规则、结果数量上限,也没有说明无匹配时的响应。该接口没有记录过实际探测调用,所有字段都来自源示例。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/players-search API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/players-search?key=<API_KEY>&plrN=Tucker'
查询结果
使用场景
- 为搜索框提供候选列表,每个结果显示姓名、球队和出生日期,让用户在打开个人资料前确认要找的球员。
- 把编辑输入的球员姓名解析成 id,再用这个 id 请求该球员的个人资料、生涯、击球或投球数据。
- 把表格或名单导入中的姓名匹配成 id,并把返回多个结果的姓名标记出来,交给人工复核。
- 做一个姓氏探索页,把搜索结果按 teamName 分组,可用于家族姓氏故事或趣味问答内容。
- 把搜索得到的姓名转成球员新闻或热门球员模块所需的 id,使用前先确认这些接口对应参数的类型。
- 列出 dob 为 N/A 的结果,找出信息不完整的球员记录,再排入你自己数据库的人工补全队列。
常见问题
plrN 里可以填什么?
填写球员姓名或姓名的一部分即可,文档中的示例是 Tucker。源文档没有说明最短长度、大小写处理、重音符号或词内部分匹配,请自行测试用户可能输入的内容。
为什么一次搜索会返回多位球员?
搜索按名字匹配,所以同一个姓氏可能对应很多人。示例中 Tucker 列出了八个条目,分属 Bermuda、Australia、Ireland、South Africa 和 Scotland。请结合 teamName 和 dob 选出要找的人,再保存其 id。
应该保存哪个字段作为球员标识?
保存 id,它在示例中是字符串,比如 Lorcan Tucker 的 11131。传给下游球员接口之前,请先核对该接口期望的类型,因为其他接口可能把球员 ID 声明为数字。
dob 为 N/A 是什么意思?
示例中 Fiachra Tucker 和 Emily Tucker 等条目的 dob 是文本 N/A,而不是日期。请把它视为出生日期未知,不要交给日期解析器处理。
faceImageId 对每个球员都是唯一的吗?
示例中并非如此。数值 182026 出现在三个不同的条目上,看起来是共用的备用图片。请不要把 faceImageId 当作人员的键,应使用 id。
没有匹配的球员时会怎样?
源文档没有记录无匹配时的响应,也没有记录过实际探测调用。请在客户端中把缺失或为空的 player 数组,以及空响应或 204 类响应,都当作零结果处理。