接口目录
接口文档
快递公司查询
更新时间:2023-05-03 接口状态:正常 免费

获取快递接口支持的快递公司

免费

接口地址:https://api.itapi.cn/api/kuaidi/com

返回格式:application/json

请求方式:HTTPSGET

请求参数:

参数名称 类型 必填 说明
key string 是 用户请求密钥,可在 密钥管理页面 申请
typestring是new:全球快递物流公司查询,为空则查询免费快递公司参数

返回参数:

参数名称 类型 说明
namestring快递公司名称
codestring快递公司code(快递查询的com值)

返回示例:

系统错误代码:

代号 说明
200 成功
400 限制或者错误
403 权限问题
500 服务器内部错误
套餐名称 套餐规格 价格
免费套餐 不限 次/天 免费  -

本站接口已整体接入 MCP(Model Context Protocol)。把下面的端点填进支持 MCP 的客户端(Cherry Studio、Cursor、Claude Desktop 等),即可让大模型以「工具」的方式调用本接口;调用等同于用你的密钥请求本接口,鉴权、计费、限流、日志与直接调用接口完全一致。

MCP 端点:https://api.itapi.cn/mcp

本接口工具名:kuaidi_com(由接口路径自动生成)

鉴权方式:请求头 Authorization: Bearer 你的密钥

工具参数:

参数名称 类型 必填 说明
type string 是 new:全球快递物流公司查询,为空则查询免费快递公司参数
* 密钥 key 由鉴权请求头传递,不作为工具参数填写。

调用示例(JSON-RPC):

复制
{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "kuaidi_com",
        "arguments": {
            "type": "<type>"
        }
    }
}

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_com","arguments":{"type":"<type>"}}}'

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_com","arguments":{"type":"<type>"}}}

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 你的密钥"
            }
        }
    }
}
说明:完整接入教程、SSE 用法与更多客户端写法见 MCP 接入说明;工具列表可通过 tools/list 获取,本站全部接口都会映射为一个工具。