Appendix

# Appendix 1: Request Header Definition

Generate signature: first concatenate public-key, timestamp, request-id and request body into a string, and then use the hmacsha256 encryption algorithm to encrypt the generated string and ackey, and convert the encrypted string into lowercase to obtain signature

{
    "signature":"6752ac7f349494c67af9f969948544eba459bebda9d6255053965a0ed44ec33a",
    "public-key":"33557c4f7ff14cbbb982660993f48a49",
    "request-id":"ddf4654b-fc9b-4d40-a914-964cff6cf379",
    "version":"1.0",
    "authorization":"81db993c3bdb45ecb9ac3943a44878dd",
    "sign-method":"HMAC-SHA256",
    "content-type":"application/json",
    "timestamp":"1701764214225"
}

# Appendix 2: Success Response Body Definition

# Success Response

```json
{
    "status":200,  
    "success": true,
    "msg": "",   
    "obj": { "token": "b509d6ef9465d9d66728d4ec1eb5ad4c"} 
}
```

# Appendix 3: Error Response Body Definition

# Error Response

```json
{
    "status":00700, 
    "success": false,
    "msg": "wrong user name or password", 
    "obj": 2 
}
```

# Appendix 4: Error Code Definition

Error Code Description
23018 Invalid parameter: imei
23510 Invalid eid
110033 ICCID parameter is illegal
23029 Device does not exist.
12209 ac info not exist
100107 AC has been allocated
12202 The ICCID does not belong to the current range
123009 batch task not exist
123010 get batch task result failed
123011 batch task item size error(1-500)
123012 eid or imei must exist
110012 operator not found
110016 Operator does not exist or is not authorized
123021 device not exist or not activated
110029 not allow switch
121013 profile is deleting
121014 profile is switching
121015 profile is downloading
123016 license not found
123017 license insufficient margin
110030 not allow delete
123022 eid and imei must not be empty
123020 device has been activated
123019 device has executing task
123025 device not connected
123015 eid and imei cannot be empty at the same time
110004 Iccid not found

# Appendix 5: Batch Result Reason

Batch Result Reason
EID,IMEI must exist at least one!
EID invalid!
IMEI invalid!
EID or IMEI repeated!
ICCID invalid!
APN invalid!
CC invalid!
AC invalid!
Repeated ICCID!
Operator does not exist!
Operator does not exist or is not authorized!