xfarrow
/
tapo-c210
mirror of https://github.com/xfarrow/tapo-c210.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update README.md

This commit is contained in:
xfarrow 2023-09-18 06:44:48 +00:00 committed by GitHub
parent f789023dcb
commit 180625e00a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 16 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
secret-apis/README.md
View File

@ -1,24 +1,24 @@
# Secret APIs # Secret APIs
Tapo cameras provide undocumented APIs we can use to control them (like using its official app). Tapo cameras provide undocumented APIs we can use to control them (simulating the use of their official app).
You can download my [Insomnia](https://github.com/Kong/insomnia) API suite [at this link](https://github.com/xfarrow/tapo-camera/blob/main/secret-apis/TapoCameraAPIs.yaml). The suite is not complete yet. You can download my [Insomnia](https://github.com/Kong/insomnia) API collection [at this link](https://github.com/xfarrow/tapo-camera/blob/main/secret-apis/TapoCameraAPIs.yaml). The collection is not complete yet.
I am writing this suite also by giving a look at the code of the awesome project [pytapo](https://github.com/JurajNyiri/pytapo). I am writing this collection also by giving a look at the code of the awesome project [pytapo](https://github.com/JurajNyiri/pytapo).
## Getting a Stok ## Getting a Stok
Each API call is in the form `https://{cameraa_ip}/stok={stok}/ds`, hence you need your camera's IP and a token, called stok. You can obtain the stok by calling the `GetStok` request. Keep in mind that this token expires every `x` minutes (did not test the actual expiration time). Each API call is in the form `https://{cameraa_ip}/stok={stok}/ds`, hence you need your camera's IP and a token, called stok. You can obtain the stok by calling `GetStok`. Keep in mind that this token expires every `x` minutes (I did not test the actual expiration time yet).
## Error codes ## Error codes
``` ```
"-40401": "Invalid stok value", -40401: Invalid stok value
"-40210": "Function not supported", -40210: Function not supported
"-64303": "Action cannot be done while camera is in patrol mode.", -64303: Action cannot be done while camera is in patrol mode.
"-64324": "Privacy mode is ON, not able to execute", -64324: Privacy mode is ON, not able to execute
"-64302": "Preset ID not found", -64302: Preset ID not found
"-64321": "Preset ID was deleted so no longer exists", -64321: Preset ID was deleted so no longer exists
"-40106": "Parameter to get/do does not exist", -40106: Parameter to get/do does not exist
"-40105": "Method does not exist", -40105: Method does not exist
"-40101": "Parameter to set does not exist", -40101: Parameter to set does not exist
"-40209": "Invalid login credentials", -40209: Invalid login credentials
"-64304": "Maximum Pan/Tilt range reached", -64304: Maximum Pan/Tilt range reached
"-71103": "User ID is not authorized", -71103: User ID is not authorized
``` ```