Lock Things Group to IMEI range (TAC)

This guide will show you how you can Enable and Disable Master IMEI settings to allow your Thing Group SIM cards to work only with one manufacturer IMEI range (TAC)

Lock Things Group to IMEI range

PUT https://console.monogoto.io/thingsgroup/{THING_GROUP_ID}

Path Parameters

Name	Type	Description
THING_GROUP_ID*	String	The identifier of your Things Group

Headers

Name	Type	Description
TOKEN_HERE*	String	Your authentication token

Request Body

Name	Type	Description
TELEPHONY_PROFILE	String	Things Group Telephony Profile ID
THINGS_GROUP_NAME	String
MASTER_IMEI_STATE	String	Replace with true or false
IMEI_PREFIX	String	Replace with the device IMEI range, also known as a TAC

200: OK OK

{
    // Response
}

Example using cURL:

curl -X PUT \
    --url "https://console.monogoto.io/thingsgroup/{THING_GROUP_ID}" \
    -H "accept: application/json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer {TOKEN_HERE}" \
    -d "{ \"TelephonyProfileId\": \"{TELEPHONY_PROFILE}\", \"ThingsGroupName\": \"{THINGS_GROUP_NAME}\", \"IMEIPrefix\": \"{IMEI_PREFIX}\", \"LockMasterImei\": {MASTER_IMEI_STATE}}"    

Please note that the above shown command needs to be replaced with information:

• {THINGS_GROUP_ID} - replace with Things Group ID

• {TOKEN_HERE} - replace with your token

• {TELEPHONY_PROFILE_ID} - replace with your Things Group used Telephony Profile ID, this can be retrieved through Get Things Group Information.
• {THINGS_GROUP_NAME} - replace with your Things Group used Telephony Profile ID from the first step.

• {IMEI_PREFIX} - replace with the device IMEI range, also known as a TAC. In order to restrict Things inside this Thing Group to work only with devices from this IMEI range. Please note that you can send empty value in order to remove IMEI range value.

• {MASTER_IMEI_STATE} - replace with true or false value, depending on what you want to do:

  • true - Enable Master IMEI limitation to allow only our entered device IMEI range to get SIM card services.

  • false - Disable Master IMEI limitation to allow all devices to work with this Thing.

Example of request:

curl -X PUT \
    --url "https://console.monogoto.io/thingsgroup/ThingsGroupId_eej3421b0-bee1-4997-93aa-ce443ca43h347a" \
    -H "accept: application/json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer eyJhb6IkpXVCJ9.eyJSb2xlIjoiVXN4lclByb2ZpbGVJZF9kZGM2MThhNC0wNTI1LTQ2MmUtYWN3NzhhMGQxYmbSI6Im4zgFkbWluIiwiQ3VzdG9tsbCwiVXNlcklkIjoiVklkXzg5Yj5Y2OGEyUtNDQThhLTEzZjA0MzJhZDE3YyINTAzgZmUtZGI51My00ZjRiLTktN2U5Yjc0ZWU1ZThlIiwiaWNzM3MjI5L2MDY3NTE2Mjl9.99aSLzP7kTgK6TZGW-xalrMu0GkW6viunt3XxbNng" \
    -d "{ \"TelephonyProfileId\": \"TelephonyProfile_ad766b40-9577-4d91-4679-01664c6834d9\", \"ThingsGroupName\": \"Project A phones\", \"IMEIPrefix\": \"35305311\", \"LockMasterImei\": true}"

Expected response (should show Thing Group ID):

ThingsGroupId_eej3421b0-bee1-4997-93aa-ce443ca43h347a

Error with : Failed to convert Swagger 2.0 to OpenAPI 3.1.1