Changes for page ONEcount API Documentation
Last modified by Rayaan Ahmed on 2025/02/09 22:20
From version 11.1
edited by Rayaan Ahmed
on 2024/02/29 16:10
on 2024/02/29 16:10
Change comment:
There is no comment for this version
To version 15.1
edited by Rayaan Ahmed
on 2025/02/09 22:20
on 2025/02/09 22:20
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -330,10 +330,6 @@ 330 330 331 331 ---- 332 332 333 -{{panel bgColor="#D3D3D3" width="100%"}} 334 -(% class="nolink nolink" %)https:~/~/api.onecount.net/v2/users 335 -{{/panel}} 336 - 337 337 === (% class="core-title" style="color:#212121" %)Request Headers(%%) === 338 338 339 339 ---- ... ... @@ -868,12 +868,6 @@ 868 868 869 869 ---- 870 870 871 -{{panel bgColor="#D3D3D3" width="100%"}} 872 - (% class="nolink nolink" %)https:~/~/api.onecount.net/v2/users/(% style="color:#212121" %)~{~{OCID}} 873 -{{/panel}} 874 - 875 -=== (% class="core-title" style="color:#212121" %)Request Headers(%%) === 876 - 877 877 ---- 878 878 879 879 (% class="Text__TextContainer-sc-1kqigik-0 cEvDCP iauueY item-key sc-fznXWL" style="color:#212121" %)Appkey (% class="Text__TextContainer-sc-1kqigik-0 iYynAw" style="color:#212121" %)~{~{ONECOUNT API KEY}} ... ... @@ -966,10 +966,6 @@ 966 966 967 967 ---- 968 968 969 -{{panel bgColor="#D3D3D3" width="100%"}} 970 - (% class="nolink nolink" %)https:~/~/api.onecount.net/v2/users(% class="nolink" style="color:#212121" %)/login 971 -{{/panel}} 972 - 973 973 === (% class="core-title" style="color:#212121" %)Request Headers(%%) === 974 974 975 975 ---- ... ... @@ -1040,10 +1040,6 @@ 1040 1040 1041 1041 ---- 1042 1042 1043 -{{panel bgColor="#D3D3D3" width="100%"}} 1044 -(% class="nolink nolink" %)https:~/~/api.onecount.net/v2/users(% class="nolink" style="color:#212121" %)/lookup?2=user_242_6298&return=1,2,3,4 1045 -{{/panel}} 1046 - 1047 1047 === (% class="core-title" style="color:#212121" %)Request Headers(%%) === 1048 1048 1049 1049 ---- ... ... @@ -1120,10 +1120,6 @@ 1120 1120 1121 1121 ---- 1122 1122 1123 -{{panel bgColor="#D3D3D3" width="100%"}} 1124 -(% class="nolink nolink" %)https:~/~/api.onecount.net/v2(% class="nolink" style="color:#212121" %)/users/~{~{OCID}}/partners/~{~{Partner id}} 1125 -{{/panel}} 1126 - 1127 1127 === (% class="core-title" style="color:#212121" %)Request Headers(%%) === 1128 1128 1129 1129 ---- ... ... @@ -1135,11 +1135,7 @@ 1135 1135 1136 1136 ---- 1137 1137 1138 -{{panel bgColor="#D3D3D3" width="100%"}} 1139 -(% class="nolink nolink" %)https:~/~/api.onecount.net/v2/users 1140 -{{/panel}} 1141 1141 1142 - 1143 1143 (% class="western" %) 1144 1144 **POST method should be used to create users.** 1145 1145 ... ... @@ -1308,11 +1308,7 @@ 1308 1308 1309 1309 ---- 1310 1310 1311 -{{panel bgColor="#D3D3D3" width="100%"}} 1312 - (% class="nolink nolink" %)https:~/~/api.onecount.net/v2/users/~{~{OCID(% class="nolink" %)}} 1313 -{{/panel}} 1314 1314 1315 - 1316 1316 (% class="western" %) 1317 1317 **PUT method should be used to update users.** 1318 1318 ... ... @@ -10165,11 +10165,101 @@ 10165 10165 } 10166 10166 {{/code}} 10167 10167 10138 +(% id="HGETspecificResource" style="margin-left: 0.0px;" class="sc-fznLPX cxTVKx" %) 10139 +== (% class="imuBmi sc-fzoaKM" id="cke_bm_37074S" style="color:#007f31; display:none" %) (% class="imuBmi sc-fzoaKM" style="color:#007f31" %)GET(% class="imuBmi sc-fzoaKM" style="color:#212121" %) users, resource id and request date based on subscription type and start date(%%) == 10168 10168 10141 +---- 10142 + 10143 + 10144 +This API will pull all the users, resource id and request date based on subscription type and start date. There are 3 types of subscription type (n, r, u) where 10145 + 10146 +n = New subscription 10147 + 10148 +r = Renew subscription 10149 + 10150 +u = unsubscribe 10151 + 10152 +start date is used to pull users who has subscription activity from the start date to current date(todays date) you can go only past 30days as a start date. 10153 + 10154 +{{panel bgColor="#D3D3D3" width="100%"}} 10155 + (% class="nolink" %)https:~/~/api.onecount.net/v2(% style="color:#212121" %)/resources(%%)/analytics?type=~{~{Subscription Type}}&start_date=~{~{Start Date}} 10156 +{{/panel}} 10157 + 10158 +=== (% class="core-title" style="color:#212121" %)Request Headers(%%) === 10159 + 10160 +---- 10161 + 10162 +(% class="Text__TextContainer-sc-1kqigik-0 cEvDCP iauueY item-key sc-fznXWL" style="color:#212121" %)Appkey (% class="Text__TextContainer-sc-1kqigik-0 iYynAw" style="color:#212121" %)~{~{ONECOUNT API KEY}} 10163 + 10164 +==== Example ==== 10165 + 10166 +---- 10167 + 10168 +(% style="color:#6b6b6b" %)Request 10169 + 10170 +{{code language="php" title="GET users, resource id and request date based on subscription type and start date"}} 10171 + <?php 10172 + 10173 +$curl = curl_init(); 10174 + 10175 +curl_setopt_array($curl, array( 10176 + CURLOPT_URL => ' https://api.onecount.net/v2/resources/analytics?type={{Subscription Type}}&start_date={{Start Date}}', 10177 + CURLOPT_RETURNTRANSFER => true, 10178 + CURLOPT_ENCODING => '', 10179 + CURLOPT_MAXREDIRS => 10, 10180 + CURLOPT_TIMEOUT => 0, 10181 + CURLOPT_FOLLOWLOCATION => true, 10182 + CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, 10183 + CURLOPT_CUSTOMREQUEST => 'GET', 10184 + CURLOPT_HTTPHEADER => array( 10185 + 'Appkey: {{ONECOUNT API KEY}}' 10186 + ), 10187 +)); 10188 + 10189 +$response = curl_exec($curl); 10190 + 10191 +curl_close($curl); 10192 +echo $response; 10193 +{{/code}} 10194 + 10195 + 10196 +(% style="color:#6b6b6b" %)Response 200 OK 10197 + 10198 +{{code language="yml" title="GET users, resource id and request date based on subscription type and start date"}} 10199 + { 10200 + "result": { 10201 + "success": "1", 10202 + "error": { 10203 + "code": "", 10204 + "message": "" 10205 + } 10206 + }, 10207 + "Resources": [ 10208 + "Resources Users": [ 10209 + { 10210 + "resource_uid": "11462", 10211 + "ocid": 74204991, 10212 + "request_date": 20250118 10213 + }, 10214 + { 10215 + "resource_uid": "11462", 10216 + "ocid": 121746390, 10217 + "request_date": 20250118 10218 + }, 10219 + { 10220 + "resource_uid": "11462", 10221 + "ocid": 45412583, 10222 + "request_date": 20250118 10223 + } 10224 + ] 10225 +} 10226 +{{/code}} 10227 + 10228 + 10169 10169 (% id="HCOMPONENT:SourceCodes" class="western" %) 10170 10170 === **COMPONENT: Source Codes** === 10171 10171 10172 -* 10232 +* 10173 10173 ** === 10174 10174 10175 10175 (% class="western" %) ... ... @@ -13662,7 +13662,7 @@ 13662 13662 (% id="HCOMPONENT:Segments" class="western" %) 13663 13663 === **COMPONENT: Segments** === 13664 13664 13665 -* 13725 +* 13666 13666 ** === 13667 13667 13668 13668 (% class="western" %) ... ... @@ -14155,7 +14155,7 @@ 14155 14155 (% id="HCOMPONENT:Leads" class="western" %) 14156 14156 === **COMPONENT: Leads** === 14157 14157 14158 -* 14218 +* 14159 14159 ** === 14160 14160 14161 14161 (% class="western" %) ... ... @@ -15332,3 +15332,138 @@ 15332 15332 (% class="western" %) 15333 15333 If the page url already exists and it doesn't match with the one that is being sent then it will throw conflict error with the title in our system. 15334 15334 ))) 15395 + 15396 +**Example 1: How to use API to get users who unsubscribed to resources in past 1 day and unsubscribe them to a package** 15397 + 15398 +**~1. Get all packages using below API call** 15399 + 15400 +[[https:~~/~~/api.onecount.net/v2/products?limit=10000>>url:https://api.onecount.net/v2/products?limit=10000]] 15401 +\\This will give all the packages with all the resources attached to that package below is sample response. 15402 + 15403 + 15404 +[ 15405 + 15406 + { 15407 + 15408 + "ProductId": 2374, 15409 + 15410 + "Title": "OptL-0- ENTECH EVENT-VSL Virtual Seminars", 15411 + 15412 + "Description": "", 15413 + 15414 + "ResourceIDs": [ 15415 + 15416 + 16366, 15417 + 15418 + 16374, 15419 + 15420 + 16638, 15421 + 15422 + 16646, 15423 + 15424 + 17030, 15425 + 15426 + 17038, 15427 + 15428 + 17046, 15429 + 15430 + 17054 15431 + 15432 + ], 15433 + 15434 + "PrimaryFormID": [ 15435 + 15436 + "251fc466-0f68-483d-afa6-1b05cb3ae9b0" 15437 + 15438 + ], 15439 + 15440 + "Terms": { 15441 + 15442 + "Id": 2462, 15443 + 15444 + "Name": "Active", 15445 + 15446 + "Description": "", 15447 + 15448 + "Duration": 1, 15449 + 15450 + "DurationUnit": "D", 15451 + 15452 + "Price": "0", 15453 + 15454 + "ProductId": 2374 15455 + 15456 + } 15457 + 15458 + } 15459 + 15460 +] 15461 + 15462 + 15463 +FYI : ResourceIDs are product ids 15464 + 15465 +Productid is package id 15466 +\\If your desired resource is in the package then use the product id and term id to unsubscribe user from that package 15467 + 15468 +**2. Get all the users who unsubscribed to resources in past 1 day** 15469 + 15470 +use below API to get all user who unsubscribed to resources in past 1 day 15471 + 15472 +[[http:~~/~~/api.onecount.net/v2/resources/analytics?type=u&start_date=20250>>url:http://api.onecount.net/v2/resources/analytics?type=u&start_date=20250110]]209 15473 + 15474 +Below is the sample response : 15475 + 15476 +{ 15477 + 15478 +"result": { 15479 + 15480 + "success": "1", 15481 + 15482 + "error": { 15483 + 15484 + "code": "", 15485 + 15486 + "message": "" 15487 + 15488 + } 15489 + 15490 + }, 15491 + 15492 +"Resources Users": [ 15493 + 15494 +{ 15495 + 15496 +"resource_uid": "11462", 15497 + 15498 +"ocid": 74204991, 15499 + 15500 +"request_date": 20250118 15501 + 15502 +}, 15503 + 15504 +{ 15505 + 15506 +"resource_uid": "11462", 15507 + 15508 +"ocid": 121746390, 15509 + 15510 +"request_date": 20250118 15511 + 15512 +} 15513 + 15514 +] 15515 + 15516 +} 15517 + 15518 +FYI: 15519 +ocid = userid 15520 + 15521 + 15522 +**3. Use user, product id and term id from the response above to unsubscribe user from the package** 15523 +\\Use this API and body to unsubscribe users 15524 +\\[[https:~~/~~/api.onecount.net/v2/transactions>>url:https://api.onecount.net/v2/transactions]] 15525 +\\**BODY:** 15526 +{"UserId": 126715990,"TermId":2462,"UserIP":"192.168.0.1" ,"SubscriptionType":"u" , "ProductId":2374 ,"ResourceId":0,"FormId": "","Source": 39,"ProductStatus": 2,"Amount":"0.00" ,"PaypalTransId":"" , "MediaFilePath":"" ,"Remarks": "USER UNSUBSCRIBED FROM API","BatchId":"1234" ,"Quantity": 1, "ExpireDate":"20260115" } 15527 +\\This will unsubscribe user from that package 15528 + 15529 +