Imported from lei-wen/sports-api-skill (
sports-api-skill/skills/sports-api-team-info/SKILL.md). Install upstream withnpx skills add lei-wen/sports-api-skill --skill sports-api-team-info. Copyright stays with the author.
球队资料
调用红火赛事数据服务的“球队资料”接口。
Endpoint
- 方法:
POST - 路径:
/api/v1/baseteaminfo - 生产环境:
https://apic.17honghuoyun.com - 请求体:文档示例使用
multipart/form-data,用 curl 的--form传参。
鉴权与本地配置
从环境变量读取凭据,绝不把真实密钥写入 Skill、命令历史、源码或输出:
SPORTS_API_APP_ID-> 请求头app-idSPORTS_API_APP_SECRET-> 请求头app-secretSPORTS_API_BASE_URL-> 可选;未设置时使用生产环境
调用前检查两个凭据变量非空;缺失时停止并请用户配置。不要输出或回显完整凭据。
请求参数
| 参数 | 类型 | 要求 | 说明 |
|---|---|---|---|
teamId |
integer | 必填 | 球队 ID |
调用模板
curl --fail-with-body --request POST \
"${SPORTS_API_BASE_URL:-https://apic.17honghuoyun.com}/api/v1/baseteaminfo" \
--header "app-id: $SPORTS_API_APP_ID" \
--header "app-secret: $SPORTS_API_APP_SECRET" \
--form 'teamId=<value>'
数组参数的具体编码方式应遵循调用方 HTTP 客户端和服务端约定;若服务端拒绝,先对照源文档示例,不要静默改成 JSON 请求体。
响应处理
响应通用结构为 {"errcode": 0, "msg": "success", "data": ...}。只有 errcode 为 0 才视为业务成功。常见错误:10001 参数缺失或无效;10002 认证失败;10003 无权限或出口 IP 未放行。
来源:https://jnjr8fzspd.feishu.cn/wiki/KugUwOiMziGWqQkNPngcttsTnoe