查询交强险投保日期API接口文档

Api接口开发者 Python 2024-02-02 19 0 原文

一、接口介绍

交强险是指在我国机动车保险中的强制保险，也是车辆所有人在机动车投保时必须购买的一项保险。查询交强险投保日期API接口旨在提供一种简便快捷地查询车辆交强险相关信息的方式，包括投保日期、到期日期等。这个接口可以帮助用户及时了解车辆交强险的情况，并进行同步更新。

二、接口地址

查询交强险投保日期API接口的地址为：https://www.wapi.cn/api/v1/insurance/query

三、请求参数

1. 车辆信息参数

参数名：car_number
参数类型：string
是否必填：是
参数说明：车牌号码，格式为：川A12345

2. 请求头参数

参数名：Authorization
参数类型：string
是否必填：是
参数说明：访问接口的凭证，需要在请求头中携带Token鉴权。

四、请求示例

curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {TOKEN}" \
-d '{
"car_number": "川A12345"
}' \
https://www.wapi.cn/api/v1/insurance/query

五、响应参数

1. 响应状态码

状态码：200
说明：成功返回数据

状态码：400
说明：请求参数错误

状态码：401
说明：未授权，需要进行Token鉴权

状态码：500
说明：服务器错误

2. 响应数据

示例：

{
"status": "success",
"data": {
"car_number": "川A12345",
"insurance_start_date": "2021-01-01",
"insurance_end_date": "2022-01-01"
}
}

参数说明：
- status：接口请求状态，"success"表示成功，"failure"表示失败。
- car_number：车牌号码。
- insurance_start_date：交强险投保日期。
- insurance_end_date：交强险到期日期。

六、错误码

1. 4001：缺少车辆信息参数car_number。
2. 4002：车辆信息参数car_number格式错误。
3. 4011：Token鉴权失败，缺少Authorization参数。
4. 4012：Token鉴权失败，Token无效或过期。
5. 5001：服务器错误，查询交强险信息失败。

七、接口使用案例

以下是一个使用该接口查询交强险投保日期的示例代码：

import requests

def query_insurance_info(car_number, token):
url = "https://www.wapi.cn/api/v1/insurance/query"
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {token}"
}
data = {
"car_number": car_number
}
response = requests.post(url, headers=headers, json=data)
if response.status_code == 200:
result = response.json()
if result["status"] == "success":
insurance_start_date = result["data"]["insurance_start_date"]
insurance_end_date = result["data"]["insurance_end_date"]
print(f"车辆{car_number}的交强险投保日期为{insurance_start_date}，到期日期为{insurance_end_date}")
else:
print("接口请求失败")
else:
print("接口请求失败")

# 调用接口查询交强险信息
token = "{YOUR_TOKEN}"
car_number = "川A12345"
query_insurance_info(car_number, token)