open.ovopark.pos.searchPos (查询POS订单)
查询pos订单,需要在请求头中添加token,token获取可以在此接口https://docs.open.ovopark.com/apidoc/detail/12/118/open.shopweb.security.mobileLogin/v1中获得
Interface Description #
| Environment | Interface Method | Submission Method | Requires Signature | The identifier of the http request |
|---|---|---|---|---|
| Formal environment | open.ovopark.pos.searchPos | POST | true | https://openapi.opretail.com/cloud.api |
Public Request Parameters #
| Parameter | Type | Required | Max Length | Description | Example Value |
|---|---|---|---|---|---|
| _aid | String | Yes | 20 | Open platform system ID, fixed as S107 | S107 |
| _akey | String | Yes | 20 | Developer key assigned by Wanzdianzhang Open Platform to third parties | Obtained after authenticating platform developer |
| _mt | String | Yes | 100 | Interface name | open.ovopark.pos.searchPos |
| _sm | String | Yes | 100 | Signature algorithm md5, sha1 | md5 |
| _requestMode | String | Yes | 100 | Request method post, get | POST |
| _version | String | Yes | 100 | Version number | v1 |
| _timestamp | String | Yes | 100 | Timestamp | yyyyMMddHHmmss format |
| _sig | String | Yes | 32 | Signature token | Generated according to signature algorithm, see signature algorithm rules for details |
| _format | String | No | 10 | Format type | Currently only json is supported by default |
Business Request Parameters #
| Parameter | Type | Required | Max Length | Description | Example Value |
|---|---|---|---|---|---|
| string | √ | 20 | 帐号 | xxxx | |
| string | √ | 20 | 密码 (需要md5加密 32位小写) | xxxxxx |
Public Response Parameters #
| Parameter | Type | Max Length | Description | Example Value |
|---|---|---|---|---|
| stat | JSON | - | Gateway status (specific parameters are described as follows: | View |
| stat.cid | String | 100 | The identifier of the http request | |
| stat.code | String | 100 | Gateway return code | |
| stat.codename | String | 100 | Gateway return code name | |
| stat.systime | String | Long | The current time of the interface call | |
| result | String | 100 | The interface returns prompt information | |
| data | JSON | - | Business information returned by the interface call (usually in JSON format, the specific data format will be defined in the business return parameters) | View |
Business Response Parameters #
| apiDetail.parameterName | Type | Required | Max Length | Description | Example Value |
|---|
Public Return Codes #
| Return code name | Return code | Return Code Description | Solution |
|---|---|---|---|
| SUCCESS | 0 | Call success | |
| KEY_NOTNULL | 1 | _akey cannot be empty | Pass in the _akey parameter when calling the interface |
| KEY_UNLAWFUL | 2 | _akey is illegal | The key is illegal, enter the correct key |
| KEY_HAS_EXPIRED | 3 | _akey has expired | Please renew your service or contact the platform administrator |
| SIGN_METHOD_NOTNULL | 4 | The _sm parameter cannot be empty | Pass in the _sm parameter when calling the interface |
| SIGN_TYPE_NOTEXIST | 5 | _sm type does not exist | Currently only supports md5, sha1 |
| SIGN_NOTNULL | 6 | The _sig parameter cannot be empty | Pass in the _sig parameter when calling the interface |
| SIGN_WRONG | 7 | Invalid signature, please check the parameters and signature format | The _sig value is generated according to the signature algorithm |
| METHOD_NOTNULL | 8 | apiDetail.mtParameterCannotBeEmpty | apiDetail.passInTheMtParameterWhenCallingTheInterface |
| METHOD_NOTEXIST_CODE | 9 | The method name corresponding to _mt does not exist or is not registered in the service | Check whether the method corresponding to the _mt method name and _version version number has an error in passing |
| REQUESTMODE_NOTNULL | 10 | The _requestMode parameter cannot be empty | Pass in the _requestMode parameter when calling the interface |
| APPLICATIONID_NOTNULL | 11 | _aid parameter cannot be empty | Pass in the _aid parameter when calling the interface |
| APPLICATIONID_NOTSAME | 12 | _aid does not match the current key | _aid and _akey must correspond one to one |
| VERSION_NOTNULL | 13 | _version version number cannot be empty | Version number |
| TIMESTAMP_NOTNULL | 14 | _timestamp timestamp cannot be empty | Pass in the _timestamp parameter when calling the interface |
| TIMESTAMP_FORMAT_ERROR | 15 | _timestamp timestamp format error | Follow the yyyyMMddHHmmss format |
| TIMESTAMP_OVERTIME | 16 | _timestamp has expired | _timestamp is regenerated each time the interface is called |
| FORMAT_TYPE_NOTEXIST | 17 | _format type does not exist | Currently only supports json (default), xml |
| API_CALL_REPEAT | -100 | Interface duplicate call | Interface platform call exception |
| API_SYSTEM_CALL_ERROR | -500 | API call failed, system exception | Interface platform call exception |
| UNKNOWN_ERROR | -999 | Open platform system exception | Reinitiate request |
Business Return Codes #
| Return code name | Return code | Return Code Description |
|---|---|---|
| 206001 | 开放平台用户不存在 | |
| 206003 | 业务平台未做绑定,请联系客服 | |
| 206004 | 部门不存在 | |
| 206006 | 代理商没有此企业权限 | |
| 999999 | api服务未知异常 | |
| 208004 | 商品详情不能为空 | |
| 208006 | 日期格式化错误 | |
| 208015 | 每页查询大小不可超过100个 | |
| 208016 | 最大查询时间范围 1 小时 | |
| 208017 | 调用次数超过上限300次 | |
| 208018 | POS数据不存在 |
