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

View File

@ -1,24 +1,24 @@
# Secret APIs
Tapo cameras provide undocumented APIs we can use to control them (like using its 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.
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 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
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
```
"-40401": "Invalid stok value",
"-40210": "Function not supported",
"-64303": "Action cannot be done while camera is in patrol mode.",
"-64324": "Privacy mode is ON, not able to execute",
"-64302": "Preset ID not found",
"-64321": "Preset ID was deleted so no longer exists",
"-40106": "Parameter to get/do does not exist",
"-40105": "Method does not exist",
"-40101": "Parameter to set does not exist",
"-40209": "Invalid login credentials",
"-64304": "Maximum Pan/Tilt range reached",
"-71103": "User ID is not authorized",
-40401: Invalid stok value
-40210: Function not supported
-64303: Action cannot be done while camera is in patrol mode.
-64324: Privacy mode is ON, not able to execute
-64302: Preset ID not found
-64321: Preset ID was deleted so no longer exists
-40106: Parameter to get/do does not exist
-40105: Method does not exist
-40101: Parameter to set does not exist
-40209: Invalid login credentials
-64304: Maximum Pan/Tilt range reached
-71103: User ID is not authorized
```