快递100接口文档快递接口api

快递100接口文档 快递接口api

快递100是一个提供快递查询、物流追踪、运单管理等服务的API接口。以下是关于快递100接口的文档：

一、接口概述

接口名称：快递查询

接口版本：v1.0

调用方式：GET

请求地址：

请求参数：

参数名类型是否必填描述access_tokenstring是用于鉴权的访问令牌，需要提前在快递100官网注册并获取。order_idstring是订单号，用于唯一标识一个订单。pageint是查询页码，默认为1。pageSizeint是每页显示的记录数，默认为20。keywordsstring是搜索关键词，多个关键词之间用英文逗号分隔。sortstring是排序字段，可选值为"date", "weight", "distance", "status"。directionstring是排序方向，可选值为"desc", "asc"。typestring是查询类型，可选值为"all"或"single"。statestring是查询状态，可选值为"active", "inactive"。areastring是查询地区，可选值为"all"或"city"。min_distancedouble否最小距离，单位为公里。max_distancedouble否最大距离，单位为公里。min_weightdouble否最小重量，单位为公斤。max_weightdouble否最大重量，单位为公斤。min_speeddouble否最小速度，单位为公里/小时。max_speeddouble否最大速度，单位为公里/小时。min_distance_unitstring否最小距离单位，可选值为"km", "m"。max_distance_unitstring否最大距离单位，可选值为"km", "m"。min_weight_unitstring否最小重量单位，可选值为"kg", "g"。max_weight_unitstring否最大重量单位，可选值为"kg", "g"。min_speed_unitstring否最小速度单位，可选值为"km/h", "m/s"。max_speed_unitstring否最大速度单位，可选值为"km/h", "m/s"。

二、请求示例

{    "access_token": "your_access_token",    "order_id": "your_order_id",    "page": 1,    "pageSize": 20,    "keywords": "test",    "sort": "date",    "direction": "desc",    "type": "all",    "state": "active",    "area": "all",    "min_distance": 50,    "max_distance": 100,    "min_weight": 10,    "max_weight": 100,    "min_speed": 10,    "max_speed": 100,    "min_distance_unit": "km",    "max_distance_unit": "km",    "min_weight_unit": "kg",    "max_weight_unit": "kg",    "min_speed_unit": "km/h",    "max_speed_unit": "km/h",}

三、返回结果

返回结果包含以下字段：

字段名类型描述totalint查询结果总数countint满足条件的订单数量resultsarray包含所有满足条件的订单信息数组statusstring订单状态order_idstring订单IDorder_numberstring订单号码datedate订单创建日期weightdouble订单重量distancedouble订单距离起点的距离（公里）speeddouble订单速度（公里/小时）status_textstring订单状态文本addressstring订单地址citystring订单所在城市provincestring订单所在省份areastring订单所在地区min_distance_unitstring最小距离单位max_distance_unitstring最大距离单位min_weight_unitstring最小重量单位max_weight_unitstring最大重量单位min_speed_unitstring最小速度单位max_speed_unitstring最大速度单位

四、注意事项

接口调用次数限制：每个IP地址每天调用次数有限制，请遵守相关规则。错误处理：接口返回的错误码和错误信息可以在中查阅。