IMIconnect Developer Hub

Welcome to the IMIconnect developer hub. You'll find all the resources to help you get started with IMIconnect quickly. We are here to support you if you get stuck. Let's jump right in!

Get Started

RTM Profile Events

The following events are generated from the RTM applications that are configured on IMIconnect with the appropriate device attribute policy. They can be used to configure new rules in services or posted to a client application through "Notify URL" action in rules.

Registration Request

{
    "data": {
        "update": {
            "os": "Android",
            "model": "XT1068",
            "osversion": "5.0.2",
            "make": "motorola",
            "imei": "353325061572362",
            "useragent": "Mozilla\/5.0 (Linux; Android 5.0.2; XT1068 Build\/LXB22.46-28; wv) AppleWebKit\/537.36 (KHTML, like Gecko) Version\/4.0 Chrome\/43.0.2357.121 Mobile Safari\/537.36",
            "language": "English",
            "resolution": "720x1184",
            "timezone": "India Standard Time",
            "teleco": "",
            "roaming": "0",
            "serialnumber": "ZX1D637KJM",
            "internalmemory": "13,091MB",
            "externalmemory": "13,091MB",
            "RAM": "888MB",
            "NFC": "0",
            "Bluetooth": "1"
        }
    },
    "appId": "AP04045412",
    "state": "Register",
    "userId": "1000",
    "deviceId": "353325061572362",
    "pushId": "APA91bErLXMGhNyDByQlIgQjtGJhLsInOMTEhJqDiBH8fxM4g_U5cL_KNLooe_TSXRszM-5EySaTlfGKORAHWuFqL9ibZkXGXyHayw-m5iX2aHJ05gEM8HKJ6J1O8HjGY0cubLht4yTg"
}

Location Change

{
    "appId": "PU30063045",
    "clientId": "PU30063045/1889/355004053370915",
    "data": {
        "update": {
            "location": [17.434709, 78.3985573],
            "oldlocation": [17.4347098, 78.3985558]
        }
    },
    "deviceId": "355004053370915",
    "event": "LOCATIONCHANGE",
    "userId": "1889"
}

Network Change

{
   "appId":"PU30063045",
   "clientId":"PU30063045/1889/355004053370915",
   "data":{
      "update":{
         "teleco":"airtel",
         "MCC":"404",
         "MNC":"49",
         "imsi":"404466006777"
      }
   },
   "deviceId":"355004053370915",
   "event":"NETWORKCHANGE",
    "userId":"1889"
}

timezone

{
    "appId": "PU30063045",
    "clientId": "PU30063045/1889/355004053370915",
    "data": {
        "update": {
            "timezone": "India Standard Time",
            "location": [17.4347098, 78.3985558]
        }
    },
    "deviceId": "355004053370915",
    "event": "TIMEZONECHANGE",
    "userId": "1889"
}

Roaming Change

{
   "appId":"SP15163316",
   "clientId":"SP15163316/1010/567D9BD2EA4D4EF78C560888AD600C0A",
   "data":{
      "update":{
         "roaming":1,
         "location":[ 17.4347098, 78.3985558]   
      }
   },
   "deviceId":"567D9BD2EA4D4EF78C560888AD600C0A",
   "event":"ROAMINGCHANGE",
    "userId":"1010"
}

idlescreen

{
   "clientId":"",
   "userId":"1000",
   "appId":"AP04045412",
   "deviceId":"353325061572362",
   "event":"ProfileUpdate",
   "state":"PROFILEUPDATE",
   "data":{
      "update":{
         "idlescreen":"1"
      }
   }
}

batterylevel

{
   "clientId":"",
   "userId":"1000",
   "appId":"AP04045412",
   "deviceId":"353325061572362",
   "event":"ProfileUpdate",
   "state":"PROFILEUPDATE",
   "data":{
      "update":{
         "batterylevel":"85.0%"
      }
   }
}

foregroundapp

{
   "clientId":"",
   "userId":"1000",
   "appId":"AP04045412",
   "deviceId":"353325061572362",
   "event":"ProfileUpdate",
   "state":"PROFILEUPDATE",
   "data":{
      "update":{
         "foregroundapp":"com.imimobile.www.rtmapp"
      }
   }
}

foreground and last_opened

{
   "clientId":"",
   "userId":"1000",
   "appId":"AP04045412",
   "deviceId":"353325061572362",
   "event":"ProfileUpdate",
   "state":"PROFILEUPDATE",
   "data":{
      "update":{
         "foreground":"1",
         "last_opened":"2014-02-28 07:25:25"
      }
   }
}

timespent

{
   "clientId":"",
   "userId":"1000",
   "appId":"AP04045412",
   "deviceId":"353325061572362",
   "event":"ProfileUpdate",
   "state":"PROFILEUPDATE",
   "data":{
      "accumulate":{
         "timespent":1
      }
   }
}

phonemode

{
   "clientId":"",
   "userId":"1000",
   "appId":"AP04045412",
   "deviceId":"353325061572362",
   "event":"ProfileUpdate",
   "state":"PROFILEUPDATE",
   "data":{
      "update":{
         "phonemode":"vibrate"
      }
   }
}

signalstrength

{
	"appId": "SP15163316",
	"event": "ProfileUpdate",
	"userId": "2162",
	"state": "PROFILEUPDATE",
	"data": {
		"update": {
			"signalstrength": "-77"
		}
	},
	"clientId": "",
	"deviceId": "358240059476333"
}

IP

{
   "appId":"PR29114917",
   "event":"OnProfileUpdate",
   "userId":"2008",
   "state":"PROFILEUPDATE",
   "data":{
      "update":{
         "IP":"192.168.2.105"
      }
   },
   "clientId":"",
   "deviceId":"353325069299604"
}

MAC

{   
   "appId":"FO11122834",   
   "event":"OnProfileUpdate",
   "userId":"100019",
   "data":{
      "update":{
         "MAC":"CC:C3:EA:FF:48:A5"
      }
   },
   "state":"PROFILEUPDATE",
   "deviceId":"353217051341173",
   "clientId":""
}

cellid

{   
   "appId":"SP15163316",
   "event":"OnProfileUpdate",
   "userId":"9999",
   "state":"PROFILEUPDATE",
   "data":{
      "update":{
         "cellid":"46152"
      }
   },
   
   "clientId":"",
   "deviceId":"867290027958296",
}

connectType

{
   
   "appId":"SP15163316",   
   "event":"OnProfileUpdate",
   "userId":"9999",
   "state":"PROFILEUPDATE",
   "data":{
      "update":{
         "connectType":"network.EDGE"
      }
   },   
   "clientId":"",
   "deviceId":"867290027958296"
}