1.Access guide

Register, log in

Obtain call credentials

Implement business logic based on interface documents

Test introduction

Function online

2.Obtain call credentialstoken

The token is the globally unique interface call credential. The token has an expiration time. After expiration, you need to refresh the token or obtain new token. The method of obtaining the token is as follows:

（1）Register and log in to the platform to obtain a third-party user’s unique credentials and credential keys, as shown in the figure:

（2）Obtain interface credential token through ClientId and Client Secret:

Token

POST

http://10.62.163.111:8882/v1/Oauth/token

Description: The expiration time is 7200 seconds. Expiration: Generate a new token; Expiration time is not reached: the token and the remaining expiration seconds are returned.

Request parameter:

	Type	Required	Example
client_id	string	Y	No1sX01PbbnLw
client_secret	string	Y	2394fb0d9faa24b72902443831667d0d
grant_type	string	Y	client_credentials

Request example:

{
 "client_id": "No1sX01PbbnLw",
 "client_secret": "2394fb0d9faa24b72902443831667d0d",
 "grant_type": "client_credentials"
}

Return result:

Parameter name	Type	Example
code	integer	0
msg	string	success
token	string	93f3f23557c6c25d76bffead16c82aebbb3d77ee104b507e38919695897a2531
expires_in	integer	5224
refresh_token	string	9e5bb4dff226e4d656d3467ca4eb882fe3379d00d5cea77c35c5aabf79d8b56d

Return example:

{
 "code": 0,
 "msg": "success",
 "token": "93f3f23557c6c25d76bffead16c82aebbb3d77ee104b507e38919695897a2531",
 "expires_in": 5224,
 "refresh_token": "9e5bb4dff226e4d656d3467ca4eb882fe3379d00d5cea77c35c5aabf79d8b56d"
}

3.Refresh credentials

Regenerate token

POST

http://10.62.163.111:8882/v1/Oauth/token

Description: Before the token expires, regenerate the token

Request parameter:

Parameter name	Type	Required	Remarks	Example
refresh_token	string	Y	refresh_token	12943601459cc83edfadddc1d65d258b7f8c9adeadf10
grant_type	string	Y	Fixed value refresh_token	refresh_token

Request example:

{
  "refresh_token": "12943601459cc83edfadddc1d65d258b7f8c9adeadf10",
  "grant_type": "refresh_token"
}

Return result:

Parameter name	Type	Remarks	Example
access_token	string	Verify identity	eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9
expires_in	int	Seconds left	7200
refresh_token	string	Before the token expires, regenerate the token	12943601459cc83edfadddc1d65d258b7f8c9adeadf10

Return example:

{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9",
  "expires_in": "7200",
  "refresh_token": "12943601459cc83edfadddc1d65d258b7f8c9adeadf10"
}

4.Verification Specification

Request method:

GET、POST、PUT、PATCH、DELETE。

Deliver content:

The parameter key value and content are passed in json string format.

Request Header:

Parameter name	Type	Required	Remarks	Example
Content-Type	String	Y	application/json	MIME Content Type.
Authorization	String	Y	Bearer <token>	Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9

5.Sample code download

Language	version	Update time
PHP	v1.01	2019-08-16
Java	v1.01	2019-08-16
Python	v1.01	2019-08-16
C#	v1.01	2019-08-16

6.Test introduction

Test domain：

http://api.demo.wareconn.com/

You can use the test domain name for development testing

POST

/v1/r/Progress/autoStn

Description:The expiration time is 7200 seconds. Expiration: Generate a new token; Expiration time is not reached: the token and the remaining expiration seconds are returned.

Request parameter:

Parameter name	Remarks	Example
part_number		MX6DC
serial_number		PLKMX6DC1379025P003QB04
status		Pass
rpn_id		VlkFoWlo
contents

Return result:

Parameter name	Remarks	Example
code		0
msg		success

Parameter name	Remarks	Example
request_no		195103333343027

You are not logged in yet,

{{lang.common_description}}:{{info.des}}

{{lang.common_requestParam}}:

{{lang.common_paramName}}	{{lang.common_type}}	{{lang.common_require}}	{{lang.common_remark}}	{{lang.common_eg}}
{{item.parameter_name}}	{{item.type}}	{{item.required}}	{{item['remark_'+langType]}}	{{item['eg_'+langType]}}	{{item.content}} {{item['remark_'+langType]}}

{{lang.common_paramName}}	{{lang.common_type}}	{{lang.common_require}}	{{lang.common_remark}}	{{lang.common_eg}}
{{it.parameter_name}}	{{it.type}}	{{it.required}}	{{it['remark_'+langType]}}	{{it['eg_'+langType]}}	{{it.content}} {{it['remark_'+langType]}}

path:

{{info.patch_doc}}

{{lang.common_requestEg}}:

{{info.getRequestUrl}}

{{lang.common_return}}:

{{lang.common_paramName}}	{{lang.common_type}}	{{lang.common_remark}}	{{lang.common_eg}}
{{item.parameter_name}}	{{item.type}}	{{item['remark_'+langType]}}	{{item['eg_'+langType]}}	{{item.content}} {{item['remark_'+langType]}}

{{lang.common_paramName}}	{{lang.common_type}}	{{lang.common_remark}}	{{lang.common_eg}}
{{it.parameter_name}}	{{it.type}}	{{it['remark_'+langType]}}	{{it['eg_'+langType]}}	{{it.content}} {{it['remark_'+langType]}}

{{lang.common_returnEg}}:

{{lang.common_keywords}}：{{this.keywords}}

1.Access guide

Register, log in

Obtain call credentials

Implement business logic based on interface documents

Test introduction

Function online

2.Obtain call credentialstoken

（1）Register and log in to the platform to obtain a third-party user’s unique credentials and credential keys, as shown in the figure:

（2）Obtain interface credential token through ClientId and Client Secret:

Token POST http://10.62.163.111:8882/v1/Oauth/token

Request parameter:

Request example:

Return result:

Return example:

3.Refresh credentials

Regenerate token POST http://10.62.163.111:8882/v1/Oauth/token

Request parameter:

Request example:

Return result:

Return example:

4.Verification Specification

Request method:

Deliver content:

Request Header:

5.Sample code download

6.Test introduction

Test domain：

You can use the test domain name for development testing

{{categoryData.title}}

{{item.name}}

{{item.name}}

{{categoryData.title}}

{{categoryData.name}}

{{info.title}}

{{lang.common_requestParam}}:

{{item.tag}}

path:

{{lang.common_requestEg}}:

{{lang.common_return}}:

{{item.tag}}

{{lang.common_returnEg}}:

{{lang.common_keywords}}：{{this.keywords}}

{{item.name}}

Token

POST

http://10.62.163.111:8882/v1/Oauth/token

Regenerate token

POST

http://10.62.163.111:8882/v1/Oauth/token