Authentication
The following guide describes how to obtain a token for usage with Monogoto API functionality.
post
https://console.monogoto.io
/Auth
Authenticate your user account to obtain a login token
Add your UserName and Password in the POST request to successfully obtain your login token.
1
{
2
"UserName": "string",
3
"Password": "string"
4
}
Copied!

Example using cURL:

1
curl -X POST \
2
-url 'https://console.monogoto.io/Auth' \
3
-H 'Content-Type: application/json' \
4
-d '{
5
"UserName": "string",
6
"Password": "string"
7
}'
Copied!
Example response showing the login token, CustomerID etc:
1
{
2
"token": "eyJhb6IkpXVCJ9.eyJSb2xlIjoiVXN4lclByb2ZpbGVJZF9kZGM2MThhNC0wNTI1LTQ2MmUtYWN3NzhhMGQxYmbSI6Im4zgFkbWluIiwiQ3VzdG9tsbCwiVXNlcklkIjoiVklkXzg5Yj5Y2OGEyUtNDQThhLTEzZjA0MzJhZDE3YyINTAzgZmUtZGI51My00ZjRiLTktN2U5Yjc0ZWU1ZThlIiwiaWNzM3MjI5L2MDY3NTE2Mjl9.99aSLzP7kTgK6TZGW-xalrMu0GkW6viunt3XxbNng",
3
"refreshToken": "eyJhb6IkpXVCJ9.eyJSb2xlIjoiVXN4lclByb2ZpbGVJZF9kZGM2MThhNC0wNTI1LTQ2MmUtYWN3NzhhMGQxYmbSI6Im4zgFkbWluIiwiQ3VzdG9tsbCwiVXN6lcklkjoiVklkXzg5Y2464OGEyUtND8ThhLTEzZjA0MzJhZDE3YyINTAgsretszgZmUtZGI51My00ZjRiLTktN2U5Yjc0ZWU1ZThlIiwiaWNzM3MjI5L2MD5786bzdhfdzhY3NTE2Mjl9.99aSLzP7kTgK6TZGW-xalrMu0GkW6viunt3XxbNng8vz567dfzgzfgEtT789D43dWEEW",
4
"CustomerId": "cid_ecs1d3a5-f5e62a1-fe8af468wf",
5
"UserId": "UserId_a76ty5a5-489a-4b87-9b9u-455f451d99fb",
6
"UserName": "[email protected]",
7
"Role": "UserProfileId_40e0998a-ef5c-4bbd-a18bc-2864y6100d1",
8
"Realm": "customer",
9
"OrganizationId": "OrganizationId_235348d7d-dd99-4111-ab2b-1ec612d9b11a",
10
"AccountSettings": {
11
"TwoFactorAuthentication": false
12
},
13
"ThingsGroupIds": [],
14
"UserProfile": {
15
"Permissions": {
16
"API": ["view"],
17
"AlertsTasksSettings": ["view", "edit", "delete"],
18
"ApnAllowedToCustomer": ["view", "edit", "delete"],
19
"AuditLogs": ["view"],
20
"AuditLogsOwned": ["view"],
21
"BillingReports": ["view"],
22
"CurrencyCodes": ["view"],
23
"Dashboard": ["view", "edit", "delete"],
24
"ExternalHLR": ["view"],
25
"GlobalSettings": ["view"],
26
"IpPools": ["view", "edit", "delete"],
27
"MobileSubscriber": ["view", "edit", "delete"],
28
"NetwSecSettings": ["view", "edit", "delete"],
29
"NetworkProvider": ["view"],
30
"NetworkProviderDetails": ["view", "edit", "delete"],
31
"PortalAlertsTasksSettings": ["view"],
32
"PortalAuditLogs": ["view"],
33
"PortalBillingReports": ["view"],
34
"PortalDashboard": ["view"],
35
"PortalIpPools": ["view"],
36
"PortalLogin": ["view"],
37
"PortalMobileIdentities": ["view"],
38
"PortalNetwork": ["view"],
39
"PortalPricePlanDetails": ["view"],
40
"PortalRealtimeDashboard": ["view"],
41
"PortalRoamingOwned": ["view"],
42
"PortalSecurity": ["view"],
43
"PortalSettings": ["view"],
44
"PortalThings": ["view"],
45
"PortalThingsGroups": ["view"],
46
"PortalUsers": ["view"],
47
"PricePlanDetails": ["view", "edit", "delete"],
48
"RoamingOwned": ["view", "edit", "delete"],
49
"Settings": ["view"],
50
"Tags": ["view", "edit", "delete"],
51
"TagsOwned": ["view", "edit", "delete"],
52
"Things": ["view", "edit", "delete"],
53
"ThingsGroup": ["view", "edit", "delete"],
54
"ThingsGroupOwned": ["view", "edit", "delete"],
55
"ThingsSensitiveData": ["view", "edit", "delete"],
56
"UserProfile": ["view"],
57
"Users": ["view", "edit", "delete"],
58
"PortalReports": ["view"],
59
"ReportTemplate": ["view", "edit", "delete"],
60
"ReportHistory": ["view", "edit", "delete"],
61
"DownloadReportInPdf": ["view", "edit", "delete"],
62
"Scheduler": ["view", "edit", "delete"],
63
"PortalScheduler": ["view"],
64
"Search": ["view7", "edit", "delete"],
65
"DownloadPCAPFile": ["view"],
66
"DataLocationService": ["view"],
67
"Bundle": ["view", "edit", "delete"]
68
},
69
"DateCreated": 1550396272390,
70
"Name": "Customer Admin",
71
"Realm": "customer",
72
"Type": "USER_PROFILE",
73
"UserProfileId": "UserProfileId_40e0998a-ef5c-4bbd-a18bc-2864y6100d1",
74
"DateModified": 1606904198590,
75
"cas": "160777788521644"
76
}
77
}
78
Copied!

Authorization Header

Once you obtained a token, make sure to add your login token to the the authorization header in all requests.
1
-H 'authorization: Bearer {YOUR_TOKEN}'
Copied!
Example
1
curl --request GET \
2
-url https://console.monogoto.io/thing/{YOUR_THING_ID}/state \
3
-H 'Accept: application/json' \
4
-H 'Authorization: Bearer {YOUR_TOKEN}'
Copied!