奥升充电|互联互通协议解析(2)——公共信息交换规范

查询充电站信息

1. 接口描述

接口名称:查询充电站信息query_stations_info

接口说明:根据查询条件查询符合条件的电站信息。             

请求格式:json

请求方式:post

2. 注意事项

  • 该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。
  • 输入参数中PageSize,PageNo缺一不可,并且PageSize最大值为100。
  • LastQueryTime建议为空,如果时间距现在较短,由于最近没有电站信息更新,可能会查为空。
  • 如果对接的电站数量较多,建议每天更新一次。
  • 电费文本格式示例:
"ElectricityFee":"电费:00:00~00:30:5.0000,00:30~01:00:5.0000,01:00~24:00:5.0000"
  • 针对电站静态信息更新时间,互联互通平台每天凌晨5点左右会从数据库更新电站数据,来供各合作伙伴查询。当天更改的电站信息,合作伙伴在第二天凌晨5点之后可以获取到。

3. 接口示例

  请求Data参数说明:

参数名称

定义

参数类型

描述

上次查询时间

LastQueryTime

string

查询的起始时间。格式为“yyyy-MM-dd HH:mm:ss”,建议为空,查询所有的充电站信息。默认结束时间为接口请求时间。

查询页码

PageNo

int

不填写默认为1

每页数量

PageSize

int

不填写默认为10

  请求示例:

https://orise.trytowish.cn/evcs/v1/query_stations_info
{
    "OperatorID": "123456789",
    "Data": "X9a+F3ql9vfyO5tcQV4srGaZm116ly2hAhG1fc0n+TMshLTw1Ax/8AT0NpZRvEhzXPqLeD1n3cVywfU+WScy7a6M9flwrOkJC5QIsp2RlFE=",
    "TimeStamp": "20180228173314",
    "Seq": "0001",
    "Sig": "407FED90C92965C8E456535A72B83F80"
}

  Data加密前:

{
    "LastQueryTime":"2016-1-2 12:12:12",
    "PageNo":1,
    "PageSize":1
}

  返回Data参数说明:

参数名称

定义

参数类型

描述

当前页数

PageNo

int

如果查询页码大于页码总数,返回查询页码数

页码总数

PageCount

int

总页数

总记录条数

ItemSize

int

符合条件的电站总数

充电站信息列表

StationInfos

StationInfo[]

类型“StationInfo”

  JSON返回示例: 

{
    "Ret": 0,
    "Msg": "",
    "Data": "cBpb1NnpoLUXbT1kc3x7M0604skZH5GD0IU9XXN40ZziSLF6KAbSbZvwpByDTGmj+wMzN/yRMrMSRswb+NuUf5qCWSPYStnhdNLjmWnl8/2vOLS2vJdwP9F7DfeOVacEb8N8atJtZ3iEseegy9RSI54JiYgaX/DlSFDFbuc4wa84TQ6jfNEsFdoKVIdMw10t9QsYjEy+qHIsMSjZLkcjnmi7+XmkgAaE1PNhIhIs1MB9Dau6df3tooGo7XtnLaf8yI3oc+/SznvSBfR/ESUe2vv3DxXLNGDsCvSnoJWLiPyRi2gsIP1lKT8+D0IO0g4doYsTAbbTaAOv4m9/s29LKAKxVGSemDr+VnIk5XWHdyv+PxYLg6srvudk9TanxYtJKv1bR2ysVX1DO2gZaqtFip36fvB5rpy3JQMoBXYQut2CQdLYtxROR9HUzGc5fIk5bQkAbKihODSJcRsFwitGL5j0yF3finJHMA1aFQ+/ouVWWeycxvOFJFRNtM/6GfYlX7E2wKQjeEUYE/zTZLQs4dmgVupUF/hpnwtU1FWd1LqeoDn/flBAdjgpQ0gtDh5cbseoo89BTXJv2z1IEl84kLZKE5scdzddFmp7zujTpmgT6+RgMACLMePyj62fwoEIXLRSoaXBaAjZ6So9abLrMjq3gfDdQ9kzXmil9wvWhW8PcJ603lYy6uM8xoz27p0wyA2OTnJfTZoVPezn1K66DHwy71Gi5PzsrhmcopJ6fLBO7FfuFphZrJYIFuJ+R5DixczDwznEo181Z75ISro+z1BI/uDNvlSpV6cSTudEZN71OUtw/500+Sp/PLkjBp9C7x+jjMfvWFQ9piadL1d7ROeRDg1Wz39S863M/PY9gg6JI73flf38/RPuWMd5YKNMkR1MLl/HisuVyn3v7GwoSD3xM8I3kcWQnTDeM1bia9H6yrz0wItqn9xXG1AuJRtQD8RKT1o1NYUVOZJRMJjiMQr2O55WcDYsgevP8N8P0WMYxKlQ/lw69UQfYtBhvvN+6r9VGpQgVG5QHDBVmp/orag0M/M1p2ZPtoD5DhiwJmbg21wrrm6SrEGO88d0+EPEcr0pG+n7HAM6xikFRHJE5yKa58hNUFa98s/WIrOyGSUh1WSNOSpDhQktC6/VLD+cgXw6lOFBxF24YpAIPt1re9u1Xs1wlpKvZUpdobbfE5ls6hT0yGEQOZopbt2+TW3rhGJfLy6nF+31HMOB8+ND9VL2X5uiWVfgihfzuzC2Lbdsx7R5wXq9KkvISRsWJBnPs3QSNmWPySJagOXdo/2dpZN/fdtwgYiweuCInTB5uX6MmqYmar3WHkI69pHqLIacMxwZ7OSnkLNkD9bABcIk61bQpuEty3X78/B32LtdwUSaMBlDSsmw2AZo1MMsnvMkbpiVAQjpi8IOwef4q5Gux8x7VUOw1dKGdfeeD3lVQZztFJT6RUPgyUY2v7PL6LaNCNkwpL+GbZa8Rh4rmwOcRwWmJAl3H9BynjzC0LDKzXob0mh0HO5dHJO0jF/wGAA5iGZJr5eiiTVsoxXaDQAn9J56S2eNZ1HAg2Gy0e1tSfKZEyzz29MnVv+wUJKRVQoNPuYZf/pMRMF/rmFiz3WyZLy5UHBET1dY9bYZcdeXKBErFf4wBKlvjhny2fYz5c0rLEBLjV9hWNUzTWlCgeEvsLXcD0YDoZJCLxCtIougoJDOMvDUgPBnNHL0PxoQI0ikj3l+kJmSnUDtMEiVtEMuFX+rB2aXFdHjCaQCNuNyv+LxwBfYVufS+9xEWolUYXKZb/llUEtAzGd92XGtj7Jgt+K1kWfhIwlVvUAiCeFQutkGAuiTgbRbkhIGw2icQ8NxAktcOHiHro57oda9ar4xrGfuYdMmzf4NNMZSTBmEw1aOU2xPyu5izc0QF3FlJB8lI40xGvCXTzaH1uOaPVMr9EVSDXq263fZLpGv2Bjo/lz8wrfuxdNJUaYyvJDV18PWQW20c53NsQUGnqokgG9gdrQttmzGUU18EOVBh5uiy6xSl/2WC/fD/uR1qwYNlevfZJXe6bk9ogqB+6Nci++Mh2pw6ZYhboRHHoxfVb5Fax6zyPgWke4BlG4wcNMB3HcE358GO/jQdbVjImIxCiinuU0JT8knlGjN5waY+e5vBtrNyjRo5cd49T1+tYgOdegn7B9gFs9WpxSJjarBBTQH22QlLJHdz43nRuPiGYU/gM1MP42R08axhj5xIXYas6saCi6h36xIJQhXq7J8DdT6Kc66dttWTItuww58gUjyOBABOwW3/T3QtAVDxTe2JHrGORU7tnH80/hNDUSmTH0I+6VOeXLFwCqm+xuJwIQoLn9aIysgXNFqLQ1UZB//+xy5iGjD3G0CFpiZvP4yHNWsHSk5XjAUe2qvj9zQKcIyzZ1ThnUufRg7k/7sd+Ftd3QUfQkF8WNHLhKS7ZGApolhLSFy1jvA8xpilQ/yoGOqp5g75yI5mXA5V7Y1KWIkEvDQNSUG76gc5mEbAVe/tQ2++QKVpFyTeXS4y4xC4HPeBMl5Rd/emMC8nuZCg1Hn2XAiGwtW0+CwfQ12EmVuQ5qQEWWXnorYgxOFekYxmsj2gvjD34nerBUDv0abfoi3FzmVvxXlczATzYz0NI0VF+BvNAiFTSqMvjw1n8XpF3NzwRyLh51YP6MJ8Ai2AiwbkvcQ1l6JHP+ehmWkGbUEfqoWJwLf21EgYK2p2nf5t7+shDRjSGn4194q2fu9VN/T3k5G+IacM4c0qj+zCzUAyW+KsBmfUVvepe0AwgNadX99S0Cv0gjxfNcu9UqpZdzNwpwgaqH7VgrcV5dDTvuaVxIRk/Ev0dphacY/ETQg8qWtFGaNG3/VYfV8lkZmbYtCtrQqa6tOPcIqpo+SYlk1Ybdn4WsYmA9UOxQjx/ZaYflqZ7ekn4d3cU6LtFwxlTTlPQb0JdqzeUr6oyfkrSgXMuGNu0fN8frinpWNWf4zclfusgwFt20tVpkBAh99YUjAZvPcaebeTp5GbPy5ejofqgYV462Rk3BdIfHK9n0Uu8SM10CLG7vjUxOybbMpGPXMQuCbC2KnDlkYleP24bUAjiKGqIPQbK+kbhGCMfmB/g7PhZl16L2nADKd9tdF8OFAaMErHFJcpu8KYl1TDVCVGPlZZjkUKlWTh0p60s3+OFT+QBiyG1hkkOmnbZVpT6Ar3WnGPNjesWSJoLjx6MVxIO7mqVIztbgVphAuMqUYKHkdAoenyChyKhQl6pjbJahfyce+egoRpILLoN8MjevoW34dYA1z3BiCD0fnfpMsJAb2h65YpPvf5S7NMR6jupoKvxXxCgwsJn9tGLi+2Q+INXZaLDDKRqEwVFCYNzCHIZ6zs88DaPf5xnOWrD+Rba35QEJn9VkFGfUzX2Qpn/SWiDlu6qi5nbF6PnRKpHvnb9oSTdeymmSPh+AM5/57+ZTCDHVkshlH3aHoTl3th5dHYRoczYb3zRBc09NOLb3iZDk4uPGzs9rRqMc/EOfxvOws8lgzRoarXJAaRa+UF9lsRe4c36L4blmxYVeaQcyMHZ2JOrI0x+EgelsvrABFHHPBLGqTRxTGB9oLNc7cXMPtzAT62FuXneYs2vH/i/JaaXrFlAH2I+5b35jB269QVt5LV1OAtP9LZ7uQAiai1BiFqZEjVXVTlMJCzKSrQz64c8QWY1IS5CzcGe1WerpqKV9WypQT5LiWLsgiCfeAhMh2+YVjfJ5STjguYAIjZX4JyzyvNu6vcJpokTGtUYbEQt2ury0YBwvAKaEnMPcE4IciTC7JWCu/AUhwk6B32To6jryp/gL2l9pzCXVbDUllBxsn5u5ijI+H4X7l23LxukXxmT9xPWeQHtka2B+emXDzDUuPh8mUtoylicLi/q6Wm3ZeWXIf6ngAVojWZt62+zotKjcdXRSYDcgUDQpIk0UPXAFmdoPBr9xBI6q+3KLh91pXewlM07cd25HbuD8y2hOXK8juLlgExV/hylyNCC0njRC72d3diLtlVl8d3W6Hjcef6p/wLnYh/0pjyqo03ri3DYTMuI3QPllUwMwVOvO3aKcZDRMMdF/zXnGwQKLE6QdN2yhMfAosAlJS57yhXA36NmrvuySqVi8KojtkmCpkdCqRqz6zH3R+v0WbC0Khh4mfJ7OPhwJtrGalhbtP4/3/TejrWrB7GKxkcGtEp/g/TYVHaGAIwWbYQE7RVvoWu2sTkQpXg9V8ucOyu3YeKiZnGzJRGzyMl7Cma8pHphapNgjo9Jt07upScN4IcFcInqAxC9U8jBIA+HYkVZeM68YjVF7rnH9TwQPaJgKJYoWZCLsVuEn6viYmAE/bI+HMx6yfT0zVbf6k4sRp8BzMQsO/fLgNGRQb0bRkzs1OKAEz/b7VqVzH1MqjToxAsgM9kt7pFXyS4P/+pSjxWX5izoslXDO8Y47PyYYoInTEWSbSUpPEDfOf8JDBPjzbw2ySLxvXXXzabaA1wKgMPgbrc/yHaEHq22kZvlUapkM3K9eV4JULVoL2ht1+t7YrZasIqJfS8XfHxZTZu776BmST5iDQyD5ULvGrLlEK4Jr3bt51hA2hhN0JLHwRJ6EquPi/1XZvXoatWjoLjOqP3VOXMpC+IQAO/o78PbncHnCiEK4H4RcKHIqx2lEYbcvJQjmQrK8K+Fjp2VS7363IoMZvNZfzBOLfGi9KWEQS2XuJ031Al2XuacbAqUdJUme0fF4WZiZpW6LBCxB4c66Ttq0W3tjiAzE/raBGUju/iUFCHCdNS9amuAG73YI+UU+e+1DeupHMjZVZM9udSHrymW2XYW9k+4GPp7U+dOdrNwVJTx2iIU8qXLJE98GDIrXxdlxsLzw5Vlx2UAdP7J7oraV//k/MDS7NT3skMZOGu8ybo5qOmDGwHdrBUcumqNqtLrRMAYpbfNjm2vHwVTbrSGjnrzMfU0hBsy03WwmeHBrfhtHoB1HAUQCNfNlzop3XUeCL8XXomss2El8Evols6afWaJ07I29OVQi7EVzflxqlr1MRenPiFiPMH2LWH8Zz5dOLt0S32qP+v6E77SQssHe4rHsoVfUuRfk+MOES+0zg0CIcGqPIj7J6MJRhXuouFhyYuOnhaHMkq6H23FLprg1uRYgj96Acq1G4vF8NghQCzk6TeIe1PokD4pGSA+H/mLAVMdHKxp9kQw0D4WhzwHJL9ahwK9N7ZxLbG5vtH33jvpOVuTa6oml9J0bL8PrPILOUxPOU/AE1EFxQKHD+zo7sCdbvapkPhmHFsmzZQ//pHrH1t1TGACIMN7YufnnYaihEYpXFk3CjcQMDIX48jj2bbzw17yLdxkZ5tSthcMe0qpzQcH6Jp3wMpszTm6jAxsC00Nzk2t7H8lSfqIHhpm0PbZ9tGiJZ1/KaO2rxbvQlCmQOGaHcLplTb0q5TIVjtV+A1teLnwd4gdCmViZcjpyqgIJLwXPcL4VUyPH/f2LO+dUM/3zW7tk0yD2SJdKafT0MEV0jqZWNnP80wt/m+45fJAK3n8cVSXyW6W3fiiRQYUo4Q0hL7TltK2pA6BEm4U40ROCT7mKCvkRGrWeqM9WoLHFr3MqkxaId/nbGqlCE9MRrSTGbIR2uwcadwcPfyD/CKL03xMI/TwdilUR2yLUsXs9trk2VxS7fbvbu91MKt+7rMsETNRmZQqhxcaDprCsdnkzIvKVTctT2kY18SvYYPuV4pwssnxr5PVB1tAdT8TyG5JPWwtVqVWoCFAKBipObDmqDEMvd1zVVmKTLZByIAsUyJGN91CiEHYd/XHZNbDPQj6OKevGtlBmCReCfvx7eDCrpjCRpRiYVTi4gWvq+FMmMoGAtfhMXMAPZ7Bd0omQDVitS5KzaNvQDMVo79lEJaDpTv2K6EevYO8WhpkwOejhujAusEgCbMG7zlZ2ES3JSi9u5F3SzADHqQLD9y0vnmdY6RJ8RKH6faujxJT/RT/JVCcyL6TnrHbDA/hRQVxB33Hj00E9o3qxon2qn+F4RXo/SxuKZkGQ7Twv0+110HzvyVELMZMo+OmR6LZq2et1KfCRB+EPSxxuy9LMDny6wT7KQwpCQ7M5KkAF1fzEaxfQxqbTfWe18JaFKGvDsJS7iEAG5ndt51RC1S4jopjKgkTgnu4K0I0zLNxz4CrC2vYRLGWDpDq8+AQ4kuGIcXmiAtkfR+w9b3QFyHXhkpk1WR5HVOjMZEEqNa3Y1gzEtVvqP00JTK7+Rz5AJb04YmyDUu2+3WdQZ/yLR4n2vpPH+DooG2EQUedJ86MgEo972zhElLGJsQqKALMbNdrVilw++DqBCasKv3x16BXdC9Xsv0e5costOTMMUgoIF3RG6Paa+9SW85mRAbV7qspGr1mjtInaALsGdt2TIxRKWLJNJARe8VTBAm+i+NC7Or/BVzkgO3pr2h3Y3ZXFujdEsJMaJ/nzxWdkyOvu8p43GP6W2PPaBH4iorpGHAASXuYqiCSJKVURBiZ8NNaZDkXhuS60Hl7aj1W1+QOjj0TRUdkNwTj37hC1BuyiSsMYvB25MpDARgdO3TN0onV3qn6s0Y39XNIDcCkCojzXzdmq4jRev1kVOr4rE8IWdRYWg9C4TKQWf5xL46/G7gRYpgey6RYwtc+8UUPyqzRVLWEx6LMz+Gw80GQ4fwUtnCUAisnWZtq+D+rtaw6M5wjpOT0hLJrw1K9VuJUG7h9zkX7QTSvVTHqaBTMTC02u9IwikSaxmcGNtsppngaR6g/8WHV5uRkQT+yuGEBVr4jd+Ri92F99XLx7RcplgQExz8k1LM/PG8l0tWWAIrOXHGtT399tGB8U9kJUXeIjv4GbYgA2TnF/uI1/XhRQTtITmoFvd3ZZLDjU48D0fGI7n5R6KPWF7jEejs0KKewHsQYi07Mh1u+5+gjE2f24dVERJSRk5gOOtSM7+EkyG8QhIdsyG0ul83wFR0FbFGx0OTey0S+r7MMTqZ76CnsDfrZwHCtW3i41HuOk+KCVLvZPryQlhE+vIHRi2PwsST28hk/ZkoSIZMwOLicvQViPmjgKhdErtQAbdDz8yO42b5wkgG/QsiC4lKT3ukzj/NsdDoU88cMqDExSMVQyJF5nUwNexs09KxTAM3S2SwoqoQoLHmUaVxH+eZOpHjuBd3Qm2qqObSpY48M6HbPxUsgitrJshHwS1vLiUQ9t5gKzfVLXHYhjxdI83++WlzWiMNxrJz9Vhif1QBWrLDDhTG50fT/7VIpNOwAthau8Q8PtDPDCTCWyIsKQVONaqtcwapPov2lmDh9J+YHUvwjj0MCv/0SJv5lEhmvQunOBevqvtHbcw4dlg8IdKw8dsAK9+pGzXHH+RCFqw2qGitYn8pewFvQ1glP61ZkelGChLg3eb0BGjBX1hA7oiwkoLWVg4XnDBHGU9kg+jKF0rEMu1GeUkmaA6s2iq5SL2yAkmJDE4bAz3hLHtjSMI7VoxFPJ090/CKfylBgPvx2Sp0FjjBOdxD9W8wLiR5GVYovgK96+/o3sTnWLxvgL6VnnmD0v3458=",
    "Sig": "F12502298D39D1274A7A368733C4BCF1"
}

  Data解密后: 

{
	"StationInfos": [{
		"EquipmentInfos": [{
				"EquipmentID": "3702810048101",
				"EquipmentName": "101号直流",
				"ManufacturerID": "395815801",
				"ManufacturerName": "奥升物联",
				"EquipmentModel": "3907060140040095",
				"ProductionDate": "",
				"EquipmentType": 1,
				"EquipmentLng": 119.996009,
				"EquipmentLat": 36.26669,
				"Power": 30.0,
				"ConnectorInfos": [{
					"ConnectorID": "3702810048101",
					"ConnectorName": "101号直流",
					"ConnectorType": 4,
					"VoltageUpperLimits": 500,
					"VoltageLowerLimits": 0,
					"Current": 60,
					"Power": 30.0,
					"ParkNo": "",
					"NationalStandard": 1
				}]
			},
			{
				"EquipmentID": "3702810048103",
				"EquipmentName": "103号交流",
				"ManufacturerID": "395815801",
				"ManufacturerName": "奥升物联",
				"EquipmentModel": "M11002B",
				"ProductionDate": "",
				"EquipmentType": 2,
				"EquipmentLng": 119.996009,
				"EquipmentLat": 36.26669,
				"Power": 7.0,
				"ConnectorInfos": [{
					"ConnectorID": "3702810048103",
					"ConnectorName": "103号交流",
					"ConnectorType": 3,
					"VoltageUpperLimits": 220,
					"VoltageLowerLimits": 0,
					"Current": 32,
					"Power": 7.0,
					"ParkNo": "",
					"NationalStandard": 2
				}]
			},
			{
				"EquipmentID": "3702810048104",
				"EquipmentName": "104号交流",
				"ManufacturerID": "395815801",
				"ManufacturerName": "奥升物联",
				"EquipmentModel": "M11002B",
				"ProductionDate": "",
				"EquipmentType": 2,
				"EquipmentLng": 119.996009,
				"EquipmentLat": 36.26669,
				"Power": 7.0,
				"ConnectorInfos": [{
					"ConnectorID": "3702810048104",
					"ConnectorName": "104号交流",
					"ConnectorType": 3,
					"VoltageUpperLimits": 220,
					"VoltageLowerLimits": 0,
					"Current": 32,
					"Power": 7.0,
					"ParkNo": "",
					"NationalStandard": 1
				}]
			},
			{
				"EquipmentID": "3702810048105",
				"EquipmentName": "105号交流",
				"ManufacturerID": "395815801",
				"ManufacturerName": "奥升物联",
				"EquipmentModel": "M11002B",
				"ProductionDate": "",
				"EquipmentType": 2,
				"EquipmentLng": 119.996009,
				"EquipmentLat": 36.26669,
				"Power": 7.0,
				"ConnectorInfos": [{
					"ConnectorID": "3702810048105",
					"ConnectorName": "105号交流",
					"ConnectorType": 3,
					"VoltageUpperLimits": 220,
					"VoltageLowerLimits": 0,
					"Current": 32,
					"Power": 7.0,
					"ParkNo": "",
					"NationalStandard": 2
				}]
			},
			{
				"EquipmentID": "3702810048106",
				"EquipmentName": "106号交流",
				"ManufacturerID": "395815801",
				"ManufacturerName": "奥升物联",
				"EquipmentModel": "M11002B",
				"ProductionDate": "",
				"EquipmentType": 2,
				"EquipmentLng": 119.996009,
				"EquipmentLat": 36.26669,
				"Power": 7.0,
				"ConnectorInfos": [{
					"ConnectorID": "3702810048106",
					"ConnectorName": "106号交流",
					"ConnectorType": 3,
					"VoltageUpperLimits": 220,
					"VoltageLowerLimits": 0,
					"Current": 32,
					"Power": 7.0,
					"ParkNo": "",
					"NationalStandard": 2
				}]
			}
		],
		"StationID": "3702810048",
		"OperatorID": "395815801",
		"EquipmentOwnerID": "395815801",
		"StationName": "奥升物联001充电站",
		"CountryCode": "CN",
		"AreaCode": "370281",
		"Address": "北京市海淀区学院路甲8号",
		"StationTel": "",
		"ServiceTel": "4001-300-001",
		"StationType": 1,
		"StationStatus": 50,
		"ParkNums": 0,
		"StationLng": 119.996009,
		"StationLat": 36.26669,
		"SiteGuide": "圣熙八号北侧",
		"Construction": 3,
		"Pictures": [
			"http://resource.teld.cn/teldimage/115/cc0618ad49024dc2844169d2ba7d0fe4.jpg",
			"http://resource.teld.cn/teldimage/115/22ac67cc696b48dab1c1a761a30603bf.jpg",
			"http://resource.teld.cn/teldimage/115/39ecf9a403ab47168e36eff7481fa7b5.jpg",
			"http://resource.teld.cn/teldimage/115/f197cb8528cc4371a7a420b7df7f5ac7.jpg"
		],
		"MatchCars": "",
		"ParkInfo": "",
		"BusineHours": "周一至周日00:00-24:00",
		"ElectricityFee": "电费:00:00~24:00:1.1200",
		"ServiceFee": "服务费:00:00~24:00:0.6000",
		"ParkFee": "免费",
		"Payment": "线上",
		"SupportOrder": 0,
		"Remark": ""
	}],
	"PageNo": 2,
	"PageCount": 584,
	"ItemSize": 584
}

设备接口状态查询

1. 接口描述

  接口名称:设备接口状态查询query_station_status

  接口说明:批量查询设备实时状态

  请求格式:json

  请求方式:post

2. 注意事项

  • 该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。
  • 注意StationIDs是字符串数组类型,数组长度不超过50,请严格按照类型传输。

3. 接口示例

  请求Data参数说明:

参数名称

定义

参数类型

描述

充电站ID 列表

StationIDs

字符串[]

数组长度不超过50

  请求示例:

https://orise.trytowish.cn/evcs/v1/query_station_status
{
	"OperatorID": "123456789",
	"Data": "rQWYvrjEhRG9euPoRD7SI2MRYQdB7KH7bTxnl4Yh9LUZEQ0mEeYbJ3QaRwFQTUJt5VDI/UmyJadRYMn8wb8fqw==",
	"TimeStamp": "20180120165755",
	"Seq": "0001",
	"Sig": "D2D584A14F3F284445DF85D0E8C0697C"
}

  Data加密前:

{
	StationIDs”: [“3702120022”, “3702120023”]
}

  返回Data参数说明:

参数名称

定义

参数类型

描述

充电站信息

StationStatusInfos

StationStatusInfo[]

根据查询条件设备状态 类型“StationStatusInfo”

  JSON返回示例: 

{
	"Ret": 0,
	"Msg": "",
	"Data": "Glr/HxHB/qS9mnFe4R6ZoBs6Mj3DCCEC5+3zfDYvgpt/Qht5nspMUUBxjS10WS74ESWunl+yzTJU1ufPeDhGn4jbAr0BTm8oGGUSDWS2ogV7dl7DyuxbJsbucypTO6QBpgwJH0FGhlYMTPI6P5d22QngyVyfQuN42W45DXJoAxWYyHH5tP6MYKB7LQQUQuO+5Fit6CcVgAC/bC26c/zlYor8XD4ZT4mbFX0qy+eAZaZaALK+0/KiXx8yvvPv7HRQ1ocS/2UnISB81WZpSBMPi1duQzAmcEGIGfKNhWT4wH4=",
	"Sig": "58E52010C7DEE87FE183B0AFA5B2BE30"
}

  Data解密后: 

{
	"StationStatusInfos": [{
			"StationID": "3702120022",
			"ConnectorStatusInfos": [{
				"ConnectorID": "3702120022101",
				"Status": 4,
			}]
		},
		{
			"StationID": "3702120023",
			"ConnectorStatusInfos": []
		}
	],
	"Total": 2
}

设备状态变化推送

1. 接口描述

  接口名称:设备状态变化推送 notification_stationStatus

  接口说明:当设备状态发生变化时,推送最新的状态。       

  请求格式:json

  请求方式:post

2. 注意事项

  • 该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。
  • 状态变化推送接口响应时间最大为3s,如果推送过去的终端在系统中不存在,直接扔掉即可,不用给特来电返回异常信息。
  • 地锁状态:  0:未知;10:已解锁;50:已上锁;255:故障
  • 车位状态:  0:未知;10:空闲;50:占用

3. 接口示例

  请求Data参数说明:

参数名称

定义

参数类型

描述

充电设备接口状态

ConnectorStatusInfo

ConnectorStatusInfo

表示设备的基本情况信息

ConnectorStatusInfo数据结构

名称

字段

描述

必填

类型

长度/范围

充电设备接口编码

ConnectorID

充电设备接口编码,同一运营商内唯一

字符串

<=26字符

充电设备接口状态

Status

0:离网

1:空闲

2:占用(未充电)

3:占用(充电中)

4:占用(预约锁定)

255:故障

整型

车位状态

ParkStatus

0:未知

10:空闲

50:占用

整型

地锁状态

LockStatus

0:未知

10:已解锁

50:已上锁

整型

  请求示例:

https://orise.trytowish.cn/evcs/v1/notification_stationStatus

{
	"OperatorID": "395815801",
	"Data": "4GzfwXXMkoRJsv3melPo78UfLHx6IjSJVD6vdK7z3bXZ+bMLpUSBcBAmfH1GeEJhL4EAJHGhwwgVDrkwTdfyW4Ue7qIiEtR8EekMWU/Fj3upAOeMIrwcPPYEd9/q6dz1oaZeCNN05Tvu0MB2lNSIRQ==",
	"TimeStamp": "20180517171155",
	"Seq": "0001",
	"Sig": "F02EB90C18707E86E2DCF06EEDDA8DDA"
}

Data加密前:

{
	"ConnectorStatusInfo": {
		"ConnectorID": "3702110116101",
		"Status": 1,
		"ParkStatus": 0,
		"LockStatus": 0
	}
}

  返回Data参数说明:

参数名称

定义

参数类型

描述

状态

Status

整型

0:接受,
  1:丢弃/忽略,不需要重试

  JSON返回示例: 

{
	"Ret": 0,
	"Msg": "",
	"Data": "KXF4GiKV/HYiKvJDbkpcsXl0V8W+Wum5KckdQLFnsqw=",
	"Sig": "1A62CA4FD6515B48EBC3CA9BD3F63724"
}

  Data解密后:

{
    "Status": 0
}

参考标准

T/CEC 102.1-2016 电动汽车充换电服务信息交换 第1部分:总则
T/CEC 102.2-2016 电动汽车充换电服务信息交换 第2部分: 公共信息交换规范
T/CEC 102.3-2016 电动汽车充换电服务信息交换 第3部分: 业务信息交换规范
T/CEC 102.4-2016 电动汽车充换电服务信息交换 第4部分: 数据传输及安全

相关链接

奥升充电|互联互通协议解析(1)——平台认证-CSDN博客

奥升充电|互联互通协议解析(2)——公共信息交换规范-CSDN博客

奥升充电|互联互通协议解析(3)——业务信息交换规范-CSDN博客

奥升充电|互联互通协议解析(4)——常见问题-CSDN博客

奥升新能源技术服务平台icon-default.png?t=N7T8https://orise.trytowish.cn/

仓库后端前端小程序
Github充电平台微服务源码充电管理后台源码充电小程序源码
GitCode充电平台微服务源码充电管理后台源码充电小程序源码
Gitee充电平台微服务源码
充电平台微服务源码(备用)
充电管理后台源码充电小程序源码

  • 5
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值