This endpoint creates a new Access Token
Enterprise license
This feature requires an Enterprise License. Please contact [email protected] for further information
Request
To create a new Access Token, please make a POST request to the following URL:
| HTTP Method | URL |
|---|---|
| POST | https://industrial.api.ubidots.com/o/token |
Key Parameters
Add the following parameters to the body of your request:
| Key | Type | Value | Required? | Description |
|---|---|---|---|---|
| grant_type | String | password | Yes | The grant authorization type |
| username | String | - | Yes | The username of the end user |
| password | String | - | Yes | The password of the end user |
| audience | String | - | No | Your API identifier |
| scope | String | read:write | Yes | The scope of the authentication, it could be for read or write purposes |
| client_id | String | - | Yes | The client ID of your account |
| client_secret | String | - | Yes | The client secret of your account |
Client ID and Client Secret
You must request the client_id and client_secret to the technical Ubidots team. Please send this request to the following e-mail: [email protected]
Header
| Parameter | Type | Description |
|---|---|---|
| Content-Type | String(application/x-www-form-urlencoded) | Content type of keys |
curl --location --request POST 'https://industrial.api.ubidots.com/o/token/' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data 'grant_type=password' \
--data 'username=check' \
--data 'password=75904268leo' \
--data 'scope=read write' \
--data 'client_id=CNpL7wnnnBdTp8uUNKDK5KjT8cV28TA6wOu4Psst' \
--data 'client_secret=TC8B8vSeVNCOuMyGIZ4Pmxjf52c8dPyteJRVjxxai5SIpNmI0APluWHBr0XLzs6i6GGAN5cViY7DnzqypKcetaq8Msky9hOeHYu46C96hgIfldqpo5IVWQJ2M57KEHhe'
{
"access_token": "UmXZ6WavsakMLtaIQ7P9p9y0M1HBSs",
"expires_in": 36000,
"token_type": "Bearer",
"scope": "read write",
"refresh_token": "aFcDvEmm0zDjJd4vcSE9AtMlIcnpoP"
}
{
"error": "invalid_grant",
"error_description": "Invalid credentials given."
}
Returns an Object containing the oAuth2 session.
List of endpoints available with Auth2
/v2.0/devices/
/v2.0/devices/<device_key>/
/v2.0/devices/<device_key>/variables//v2.0/variables/
/v2.0/variables/<variable_key>//v1.6/variables/<variable_key>/values
/api/v2.0/users/
/api/v2.0/users/<user_key>
Header
| Parameter | Type | Description |
|---|---|---|
| Content-Type | String(application/json) | Content type of body |
| Authorization: Bearer | String | Access Token |
curl --request GET \
--url 'https://industrial.api.ubidots.com/api/v2.0/devices/' \
-H 'Authorization: Bearer cBBLtgOhfYImGiH47QLG1OTKjtqDd0'\
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"url": "https://industrial.api.ubidots.com/api/v2.0/devices/639a820378b2b3000cd18c0e",
"id": "639a820378b2b3000cd18c0e",
"organization": {
"url": "https://industrial.api.ubidots.com/api/v2.0/organizations/62b4eb3519cd98007bf410bf",
"id": "62b4eb3519cd98007bf410bf",
"label": "my-third-customer",
"name": "Cliente1",
"createdAt": "2022-06-23T22:37:41.840643Z"
},
"label": "xbee",
"name": "xbee",
"description": "",
"tags": [],
"properties": {},
"isActive": true,
"lastActivity": 1671110138954,
"createdAt": "2022-12-15T02:10:11.432971Z",
"variables": "https://industrial.api.ubidots.com/api/v2.0/devices/639a820378b2b3000cd18c0e/variables",
"variablesCount": 1
}
]
}
{
"code": 401002,
"message": "Incorrect authentication credentials."
}
Returns an object with the requested endpoint.