Metadata-Version: 2.4
Name: tb-rest-client
Version: 4.3
Summary: ThingsBoard REST API client
License: Apache-2.0
License-File: LICENSE
Keywords: tb-python-rest-client,tb-rest-client
Author: ThingsBoard
Author-email: info@thingsboard.io
Maintainer: Vitalii Bidochka
Maintainer-email: vbidochka@thingsboard.io
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: certifi (>=2023.7.22)
Requires-Dist: pyjwt (>=2.6.0)
Requires-Dist: python_dateutil (>=2.5.3)
Requires-Dist: requests (>=2.31.0)
Requires-Dist: setuptools (>=21.0.0)
Requires-Dist: six (>=1.10)
Requires-Dist: urllib3 (>=2.0.7)
Project-URL: Documentation, https://thingsboard.io/docs/reference/python-rest-client/
Project-URL: Homepage, https://thingsboard.io/docs/reference/python-rest-client/
Project-URL: Repository, https://github.com/thingsboard/thingsboard-python-rest-client
Description-Content-Type: text/markdown

# ThingsBoard Python REST API client

[![Join our Discord](https://img.shields.io/badge/Discord-Join%20our%20server-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/mJxDjAM3PF)

The ThingsBoard REST API Client helps you interact with [ThingsBoard REST API](https://thingsboard.io/docs/reference/rest-api/) from your Python script.  
With [Python Rest Client](https://thingsboard.io/docs/reference/python-rest-client/) you can programmatically create assets, devices, customers, users and other entities and their relations in ThingsBoard.

The recommended method for installing the Rest Client is a pip.  

*The Python version of the REST API client is under developing. If you have discovered any bug, please write us using email or by opening the issue.*


##### Installation 

In order to install the ThingsBoard REST client, you should use the following command:

```bash
pip3 install tb-rest-client
``` 


##### Examples 

You can find the examples of the usage in the "examples" folder or on the [our website](https://thingsboard.io/docs/reference/python-rest-client/).


**Note:** There are 2 REST clients for ThingsBoard, they are depend on version of the ThingsBoard, you use.  

 - If you use the ThingsBoard Community Edition (ThingsBoard CE) - please use the following command to import the REST client into your script:  
   `from tb_rest_client.rest_client_ce import *`  
   The REST client class has name "RestClientCE".  
   
 - If you use the ThingsBoard Professional Edition (ThingsBoard PE) - please use the following command to import the REST client into your script:  
   `from tb_rest_client.rest_client_pe import *`  
   The REST client class has name "RestClientPE".  

If you use the wrong version of the REST client, it could work unexpectedly.


## Support

 - [Join our Discord](https://discord.gg/mJxDjAM3PF)
 - [Community chat](https://gitter.im/thingsboard/chat)
 - [Q&A forum](https://groups.google.com/forum/#!forum/thingsboard)
 - [Stackoverflow](http://stackoverflow.com/questions/tagged/thingsboard)
 
**Don't forget to star the repository to show your ❤️ and support.**


## Licenses

This project is released under [Apache 2.0 License](./LICENSE).

