API Lists

1. Query Equipment Authorization

1.1 API Definition

API Name: query_equip_auth

Use Case: The infrastructure provider (who owns electric chargers/swap stations) provided this API, and the service platform ( who requests to charge) will call it.

1.2 Request (Input Paramters)

Chinese Name	Parameter Name	Data Type	Chinese Description
设备认证流水号	EquipAuthSeq	String	格式”运营商ID+唯一编号”, 27字符
充电设备接口编码	ConnectorID	String

1.3 Response (Return Value)

Chinese Name	Parameter Name	Data Type	Chinese Description
设备认证流水号	EquipAuthSeq	String	格式”运营商ID+唯一编号”, 27字符
充电设备接口编码	ConnectorID	String
操作结果	SuccStat	Integer	0：成功； 1：失败；
失败原因	FailReason	Integer	0：无； 1：此设备未插枪； 2：设备检验失败； 3-99：自定义；

---

2. Query Equipment Business Policy

2.1 API Definition

API Name: query_equip_business_policy

Use Case: The infrastructure provider (who owns electric chargers/swap stations) provided this API, and the service platform ( who requests to charge) will call it.

2.2 Request (Input Paramters)

Chinese Name	Parameter Name	Is Mandatory?	Data Type	Chinese Description
业务策略查询流水号	EquipBizSeq	Yes	String	格式”运营商ID+唯一编号”, 27字符
充电设备接口编码	ConnectorID	Yes	String

2.3 Response (Return Value)

Chinese Name	Parameter Name	Is Mandatory?	Data Type	Chinese Description
业务策略查询流水号	EquipBizSeq	Yes	String	格式”运营商ID+唯一编号”, 27字符
充电设备接口编码	ConnectorID	Yes	String
操作结果	SuccStat	Yes	Integer	0：成功； 1：失败；
失败原因	FailReason	Yes	Integer	0：无； 1：此充电桩业务策略不存在①；
时段数 N	SumPeriod	Yes	Integer	Range: 0-32
计费信息	PolicyInfos	Yes	policyInfos Array	单项业务策略信息体

① In this case, the most likely reason is that the infrastructure provider failed to announce or publish the stations to the service platform system.

---

3. Query Start Charge

3.1 API Definition

API Name: query_start_charge

Use Case: The infrastructure provider (who owns electric chargers/swap stations) provided this API, and the service platform ( who requests to charge) will call it.

2.2 Request (Input Paramters)

Chinese Name	Parameter Name	Is Mandatory?	Data Type	Chinese Description
充电订单号	StartChargeSeq	Yes	String	格式”运营商ID+唯一编号”, 27字符
充电设备接口编码	ConnectorID	Yes	String
二维码其他信息	QRCode	Yes	String	二维码中含有自定义部分的,需要将二维码自 定义部分的原文传输。

2.3 Response (Return Value)

Chinese Name	Parameter Name	Is Mandatory?	Data Type	Chinese Description
充电订单号	StartChargeSeq	Yes	String	格式”运营商ID+唯一编号”, 27字符
充电订单状态	StartChargeSeqStat	Yes	Integer	1：启动中； 2：充电中； 3：停止中； 4：已结束； 5：未知；
充电设备接口编码	ConnectorID	Yes	String
操作结果	SuccStat	Yes	Interger	0：成功; 1：失败；
失败原因	FailReason	Yes	Interger	0：无； 1：此设备不存在； 2：此设备离线； 3-99：自定义；

---