接口目录
接口文档
通过寄件信息、收件信息，查询快递公司该线路是否支持寄送，减少退回、发货失败等情况，提升用户体验，减少物流成本。
输入充值金额：
接口地址：https://api.itapi.cn/api/kuaidi/stopone
返回格式：application/json
请求方式：HTTPSGET
请求参数：
| 参数名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 用户请求密钥，可在 密钥管理页面 申请 |
| com | string | 是 | 快递公司简称：yuantong,shunfeng,jd,zhongtong,zhongtongkuaiyun,shentong,yunda,ems,jtexpress,debangkuaidi,youzhengguonei,fengwang |
| fromadd | string | 是 | 寄件人地址，如：张三，13800138000，广东省深圳市南山区 ！可选~ |
| toadd | string | 是 | 智能识别收件人地址，如：张三，13800138000，广东省深圳市南山区 ！ 必填 |
返回参数：
| 参数名称 | 类型 | 说明 |
|---|---|---|
| com | string | 快递公司简称 |
| status | string | 状态：0 不可达，1 可达 |
| reason | string | 原因 |
| express | string | 快递公司中文名 |
系统错误代码：
| 代号 | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 限制或者错误 |
| 403 | 权限问题 |
| 500 | 服务器内部错误 |
| 按量套餐 | 套餐规格 | 价格 | ||
|---|---|---|---|---|
| 所有会员 | 不限 次/天 | 2点 / 次 | ≈0.002元 / 次 | |
| * 点数支持所有标注为按量计费的产品抵扣。 | ||||
本站接口已整体接入 MCP（Model Context Protocol）。把下面的端点填进支持 MCP 的客户端（Cherry Studio、Cursor、Claude Desktop 等），即可让大模型以「工具」的方式调用本接口；调用等同于用你的密钥请求本接口，鉴权、计费、限流、日志与直接调用接口完全一致。
MCP 端点：https://api.itapi.cn/mcp
本接口工具名：kuaidi_stopone（由接口路径自动生成）
鉴权方式：请求头 Authorization: Bearer 你的密钥
工具参数：
| 参数名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| com | string | 否 | 快递公司简称：yuantong,shunfeng,jd,zhongtong,zhongtongkuaiyun,shentong,yunda,ems,jtexpress,debangkuaidi,youzhengguonei,fengwang |
| fromadd | string | 否 | 寄件人地址，如：张三，13800138000，广东省深圳市南山区 ！可选~ |
| toadd | string | 否 | 智能识别收件人地址，如：张三，13800138000，广东省深圳市南山区 ！ 必填 |
* 密钥 key 由鉴权请求头传递，不作为工具参数填写。 | |||
调用示例（JSON-RPC）：
复制{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kuaidi_stopone",
"arguments": {
"com": "<com>",
"fromadd": "<fromadd>",
"toadd": "<toadd>"
}
}
}cURL 调用：
复制curl -X POST 'https://api.itapi.cn/mcp' \
-H 'Authorization: Bearer 你的密钥' \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"kuaidi_stopone","arguments":{"com":"<com>","fromadd":"<fromadd>","toadd":"<toadd>"}}}'Python 调用：
复制import requests
url = 'https://api.itapi.cn/mcp'
headers = {'Authorization': 'Bearer 你的密钥', 'Content-Type': 'application/json'}
payload = {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"kuaidi_stopone","arguments":{"com":"<com>","fromadd":"<fromadd>","toadd":"<toadd>"}}}
print(requests.post(url, json=payload, headers=headers, timeout=60).json())客户端配置：
复制{
"mcpServers": {
"itapi": {
"type": "streamable-http",
"url": "https://api.itapi.cn/mcp",
"headers": {
"Authorization": "Bearer 你的密钥"
}
}
}
}tools/list 获取，本站全部接口都会映射为一个工具。
