按 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 功能

按姓名片段搜索 plrN 可以填球员姓名或姓名的一部分。像 Tucker 这样的姓氏会在一次响应里返回所有匹配条目,用户可以从列表中挑出要找的人。
用球队和出生日期区分重名 每条匹配结果都带有 teamName 和 dob,可以区分姓氏相同的球员,例如示例中来自 Bermuda、Ireland 和 South Africa 的几位球员。
字符串类型的球员 id id 字段是字符串,如 11131。请把它当作稳定的键,用于后续的个人资料、生涯、击球、投球和球员新闻请求,不要再反复按名字匹配。
头像图片标识 faceImageId 是数字,可配合本产品的图片接口显示头像。示例中 182026 在多个条目上重复出现,看起来是共用的备用图片。
回显的搜索分类 category 字段会原样返回提交的搜索文本,客户端可以借此确认某条缓存响应或异步响应对应的是哪一次查询。
未知出生日期的标记 日期未知时 dob 的值是文本 N/A 而不是日期,示例中的 Fiachra Tucker 和 Emily Tucker 就是如此,客户端在解析之前必须先判断这个值。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

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 类响应,都当作零结果处理。

相关接口

相关指南

查看订阅方案 →