API Documentation
Introduction
The Thyngs Web API makes it easy to build new products and services onto the Thyngs platform.
The API accepts JSON and XML encoded content as an input. The output is set by default to JSON format, but it can be changed to XML by providing a Content-type: application/xml header in the request.
The API can be reached at https://apistaging.thyngs.net/api. For example you can use the following to request the information linked to a Thyngs with Code ANA00014
https://api.thyngs.net/api/v1/ThyngDetails?ThyngCode=ANA00014
Any REST client can be used to test the API but we love Post Man
UpdateUserProfile
Update User Information if Security check is cleared
| API | Description |
|---|---|
| POST api/v1/UpdateUserProfile?appUserID={appUserID}&thyngCode={thyngCode}&emailAddress={emailAddress}&userName={userName} |
Update User Information if Security Check is successful |
| POST api/v2/UpdateUserProfile?appUserID={appUserID}&thyngCode={thyngCode}&emailAddress={emailAddress}&userName={userName} |
Update User Information if Security Check is successful |
Loyalty
| API | Description |
|---|---|
| POST api/v1/Loyalty |
No documentation available. |
| POST api/v2/Loyalty |
No documentation available. |
MinimumAppVersion
Retrieve the minimum supported app version for a given platfrom
| API | Description |
|---|---|
| GET api/v1/MinimumAppVersion?platform={platform} |
Retrieve the minimum supported app version for a given platfrom |
| GET api/v2/MinimumAppVersion?platform={platform} |
Retrieve the minimum supported app version for a given platfrom |
AddUser
| API | Description |
|---|---|
| POST api/v1/AddUser |
No documentation available. |
| POST api/v2/AddUser |
No documentation available. |
NearbyThyngs
Retrive a List of thyngs that the User has previously interacted with
| API | Description |
|---|---|
| GET api/v1/NearbyThyngs?userID={userID}&latitude={latitude}&longitude={longitude} |
Return a List of thyngs that the given User has previously interacted with |
| GET api/v2/NearbyThyngs?userID={userID}&latitude={latitude}&longitude={longitude} |
Return a List of thyngs that the given User has previously interacted with |
Conversions
Reports conversions for user
| API | Description |
|---|---|
| GET api/v1/Conversions?appUserId={appUserId} |
Reports conversions for user. This API route is protected, supply 'auth-token' key in the header of the request with your integration auth token. |
| GET api/v2/Conversions?appUserId={appUserId} |
Reports conversions for user. This API route is protected, supply 'auth-token' key in the header of the request with your integration auth token. |
ThyngDetails
Retrieve information about a Thyng
| API | Description |
|---|---|
| GET api/v1/ThyngDetails?thyngCode={thyngCode}&verification={verification}&appUserID={appUserID}&techCode={techCode}&version={version} |
Retrieve information about any given Thyng |
| GET api/v2/ThyngDetails?thyngCode={thyngCode}&verification={verification}&appUserID={appUserID}&techCode={techCode}&version={version} |
Retrieve information about any given Thyng |