Web API V1.

1
In order to unify the protocol connection between this controller and various MES systems,
the interface specification is now defined and sample data for calling is provided.
As a server, this controller manages the tightening results and parameters of electric
screwdriver. The client can interact with the tightening results (including final tightening data
and tightening curves), barcode passing and other operations by calling the public http
interface.
Requests and responses content-type: application/json

1. Get tightening results

1.1 Interface definition

Function: Get unmarked tightening result data in the electric screwdriver
controller, including tightening data and curves.

url: http://x.x.x.x:9659/open/result

Request method：GET

Request parameters are defined in the table below:

parameters type info
Get the number of unmarked data. Range (1-20) Default
count int
value is 10
Whether to obtain the curve. 0 means not to obtain, 1
showCurve int
means to obtain, the default value is 0
Product barcode, can be empty, default is not entered to
barcode string
obtain all barcode data

Response data Response body json parameter Description：

parameters type info

code int Response code, 0 indicates success, others indicate failure

Error and prompt information when failure or reminder

msg string
occurs

data Json object Returned list of fastening results

page 1 ， 6 pages in total

1.2 Example
Request：

http://127.0.0.1:9659/open/result?showCurve=1&count=1

Success response：

{
"code": 0,
"msg": "success",
"data": [
{
"id": "F9026934-D8E8-402E-A55E-DF6DD5C6B07A", // Unique ID
"angleCurve": "111,151,194,236,283,329,375,421,467 ",// angle curve point
"torqueCurve": "0.32,0.41,0.77,0.57,0.7,0.4,0.81,0.31, ",// torque curve point
"barcode": "SN2302", // barcode
"dateTime": "2023-04-04 15:30:31", // time
"errorReport": 0, // 0 None，1 screw stripped，2 incomplete tightening，3 Bad torque，
4 Bad tightening angle，5 stopover
"Line": "Line1", // Line
"station": "MP11", // station
"position": 1, // Screw position
"direction": 0, // 1 forward，0 reverse
"result": 0, // 0 OK，1 NG
"targetTorque": 1.235, // Torque value
"targetTorqueLo": 0.45, // Torque value lower limit
"targetTorqueUp": 1.45, // Torque value upper limit
"inAngle": 1995, // Angle
"inAngleLo": 1080, // Angle lower limit
"inAngleUp": 3665, // Angle upper limit
"tightenAngle": 50, // Tightening angle
"tightenAngleLo": 10, // Tightening angle lower limit
"tightenAngleUp": 120 // Tightening angle lower upper
}
]
}
Error response：
{
"code": 100,
"msg": "error",

page 2 ， 6 pages in total

 "data": null
}

2. Mark tightening results

2.1 Interface definition

Function: Mark the data in the controller. The marked data will no longer

be returned when subsequent tightening results are obtained.

url: http://x.x.x.x:9659/open/result/mark

Request method：POST

Request body parameters：

[
"F9026934-D8E8-402E-A55E-DF6DD5C6B07A",
"A0679575-7E94-487B-8301-E7BDE07320AD"
]
// The unique Id of the result , This is an array into which
multiple pieces of data can be inserted.

Response data Response body json parameter Description：

parameters type Info

code int Response code, 0 indicates success, others indicate failure

Error and prompt information when failure or reminder

msg string
occurs

2.2 Example
Request：

http://127.0.0.1:9659/open/result/mark

Request body：
[
"F9026934-D8E8-402E-A55E-DF6DD5C6B07A", // The unique id of the result
"A0679575-7E94-487B-8301-E7BDE07320AD "
]
page 3 ， 6 pages in total
 Success response：
{
"code": 0,
"msg": "success",
"data": null
}
Error response：
{
"code": 100,
"msg": "error",
"data": null
}

3. Pass-through barcode (Not yet provided)

3.1 Interface definition

Function: Write the barcode that allows passing through the station

url: http://x.x.x.x:9659/open/barcode

Request method：GET

Response data Response body json parameter Description：

parameter type info

barcode string Barcode that allows passing through

Response data Response body json parameter Description：

parameters type Info

code int Response code, 0 indicates success, others indicate failure

Error and prompt information when failure or reminder

msg string
occurs

3.2 Example
Request：

http://127.0.0.1:9659/open/barcode?barcode=SN2302

page 4 ， 6 pages in total

 Success response：
{
"code": 0,
"msg": "success",
"data": null
}
Error response：
{
"code": 100,
"msg": "error",
"data": null
}

4. Delete transit barcode (Not yet provided)

4.1 Interface definition

Function: Delete the pass-through barcode. I n t h e d e f a u l t s y s t e m , this
barcode will be deleted after tightening in the screws that allow the pass-through
barcode. Therefore, this function is suitable for deletion operations after
mistakenly writing the pass-through barcode.

url: http://x.x.x.x:9659/open/barcode/remove

Request method：GET

Response data Response body json parameter Description：

parameter type info

barcode string barcode to be deleted

Response data Response body json parameter Description：

parameters type Info

code int Response code, 0 indicates success, others indicate failure

Error and prompt information when failure or reminder

msg string
occurs

4.2 Example
Request：

http://127.0.0.1:9659/open/barcode/remove?barcode=SN2302
page 5 ， 6 pages in total
 Success response：
{
"code": 0,
"msg": "success",
"data": null
}
Error response：
{
"code": 100,
"msg": "error",
"data": null
}

page 6 ， 6 pages in total