{"id":13727,"date":"2023-10-16T08:17:15","date_gmt":"2023-10-16T13:17:15","guid":{"rendered":"https:\/\/docs.iotconnect.io\/partnerprogram\/?page_id=13727"},"modified":"2023-10-27T07:08:01","modified_gmt":"2023-10-27T12:08:01","slug":"iot-partner-program-and-iotconnect-integration-using-apis","status":"publish","type":"page","link":"https:\/\/docs.iotconnect.io\/partnerprogram\/concepts\/iot-partner-program-and-iotconnect-integration-using-apis\/","title":{"rendered":"IoT Partner Program And IoTConnect Integration Using APIs"},"content":{"rendered":"<p>The first step in your IoT journey is to create app\/product in IoT Partner Program. The next step, a big one, is to make your solutions available to the users. This can be done by integrating your app\/product created in IoT Partner Program with \/IOTCONNECT\u2122.<\/p>\n<p>By leveraging APIs you can ensure interoperability and bridge the gap between IoT Partner Program and our IoT platform. APIs provide the needed interface between devices, solutions and their usability.<\/p>\n<h3>Moving from products to platform<\/h3>\n<p>If you want to create solutions, you are first required to define your app\/product in IoT Partner Program by adding product details. To learn more about how to manage your product, you can refer to our <a href=\"https:\/\/docs.iotconnect.io\/partnerprogram\/partner-program-user-guides\/products\/\">user guide.<\/a><\/p>\n<p>Once the product is created you will be required to enter details for the instance and environment that you need to use. Once you save the environment information, you will get the following details:<\/p>\n<ul>\n<li>Portal URL<\/li>\n<li>API URL<\/li>\n<li>API Key<\/li>\n<li>Secret Key<\/li>\n<li>Solution Key<\/li>\n<li>Consumer APIs<\/li>\n<\/ul>\n<p>There are two modules: API Auth and Integration, used to create company and admin user on \/IOTCONNECT\u2122 with your solutions.<\/p>\n<p>Below are the steps you need to follow to create company and admin user:<\/p>\n<h3>Step 1 &#8211; Get integration API details<\/h3>\n<p>You will get API URL with API key and secret key to get the access token for creating company on \/IOTCONNECT\u2122.<\/p>\n<h3>Step 2 &#8211; Get Basic token using Auth API &#8211; basic token<\/h3>\n<p>You will also get the AUTH API endpoint that contains basic-token GET method which you need to use in next step.<\/p>\n<p>API End point \u2013GET <strong>api\/v2\/Auth\/basic-token<\/strong><\/p>\n<h3>Step 3 &#8211; Get Access Token using Auth API &#8211; API-login<\/h3>\n<p>API End point \u2013POST <strong>api\/v2\/Auth\/api-login<\/strong><\/p>\n<p><strong><em>Request <\/em><\/strong><\/p>\n<p><strong><em>Header <\/em><\/strong><\/p>\n<div class=\"table-responsive\">\n<table width=\"1315\">\n<thead>\n<tr>\n<td><strong>Component<\/strong><\/td>\n<td><strong>Description<\/strong><\/td>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Content-type<\/td>\n<td>application\/json<\/td>\n<\/tr>\n<tr>\n<td>Authorization<\/td>\n<td>Basic [BASIC-TOKEN] (step 2)<\/td>\n<\/tr>\n<tr>\n<td>solution-key<\/td>\n<td>[SOLUTION_KEY]\u00a0 (you will get in the product details section)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<p>&nbsp;<\/p>\n<p><em>Body<\/em><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"null\">{\r\n\r\n\u00a0 \"app-key\": \"string\",\u00a0\u00a0 \/\/ that you get from the product details section\r\n\r\n\u00a0 \"app-secret\": \"string\", \/\/ that you get from the product details section\r\n\r\n\u00a0 \"customETPlaceHolders\": \"string\" \/\/ pass empty string\r\n\r\n}\r\n<\/pre>\n<p><strong><em>Response<\/em><\/strong> \u2013 you will get access token that we will use for creating company.<\/p>\n<p>&nbsp;<\/p>\n<h3>Step 4 &#8211; Create company<\/h3>\n<p>API End point \u2013POST <strong>api\/v2\/company<\/strong><\/p>\n<p><strong><em>Header <\/em><\/strong><\/p>\n<div class=\"table-responsive\">\n<table width=\"1315\">\n<thead>\n<tr>\n<td><strong>Component<\/strong><\/td>\n<td><strong>Description<\/strong><\/td>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Content-type<\/td>\n<td>application\/json<\/td>\n<\/tr>\n<tr>\n<td>Authorizatio<\/td>\n<td>Bearer [ACCESS-TOKEN] (step 3)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<p><strong><em>Body<\/em><\/strong><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"null\">{\u00a0 \"cpid\": \"string\",\u00a0 \"firstName\": \"string\",\u00a0 \"lastName\": \"string\",\u00a0 \"userId\": \"string\",\u00a0 \"name\": \"string\",\u00a0 \"address\": \"string\",\u00a0 \"city\": \"string\",\u00a0 \"stateGuid\": \"string\",\u00a0 \"countryGuid\": \"string\",\u00a0 \"timezoneGuid\": \"string\",\u00a0 \"contactNo\": \"string\",\u00a0 \"fax\": \"string\",\u00a0 \"customETPlaceHolders\": {}}<\/pre>\n<p><strong><em>Response<\/em><\/strong><\/p>\n<p>This step will create company and admin user in \/IOTCONNECT\u2122. Admin will receive email of invitation to set his login password for \/IOTCONNECT\u2122.<\/p>\n<p>To get a better understanding, you can refer to our <a href=\"https:\/\/docs.iotconnect.io\/partnerprogram\/concepts\/greenhouse-use-case\/\">Greenhouse use case<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The first step in your IoT journey is to create app\/product in IoT Partner Program. The next step, a big one, is to make your solutions available to the users. This can be done by integrating your app\/product created in IoT Partner Program with \/IOTCONNECT\u2122. By leveraging APIs you can ensure interoperability and bridge the [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":13705,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template-page-full-width.php","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0},"acf":[],"_links":{"self":[{"href":"https:\/\/docs.iotconnect.io\/partnerprogram\/wp-json\/wp\/v2\/pages\/13727"}],"collection":[{"href":"https:\/\/docs.iotconnect.io\/partnerprogram\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.iotconnect.io\/partnerprogram\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.iotconnect.io\/partnerprogram\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.iotconnect.io\/partnerprogram\/wp-json\/wp\/v2\/comments?post=13727"}],"version-history":[{"count":3,"href":"https:\/\/docs.iotconnect.io\/partnerprogram\/wp-json\/wp\/v2\/pages\/13727\/revisions"}],"predecessor-version":[{"id":13907,"href":"https:\/\/docs.iotconnect.io\/partnerprogram\/wp-json\/wp\/v2\/pages\/13727\/revisions\/13907"}],"up":[{"embeddable":true,"href":"https:\/\/docs.iotconnect.io\/partnerprogram\/wp-json\/wp\/v2\/pages\/13705"}],"wp:attachment":[{"href":"https:\/\/docs.iotconnect.io\/partnerprogram\/wp-json\/wp\/v2\/media?parent=13727"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}