From 180625e00a88664bcfbb9e56ca51f47ac405074a Mon Sep 17 00:00:00 2001 From: xfarrow Date: Mon, 18 Sep 2023 06:44:48 +0000 Subject: [PATCH] Update README.md --- secret-apis/README.md | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/secret-apis/README.md b/secret-apis/README.md index 1b86f09..43c4460 100644 --- a/secret-apis/README.md +++ b/secret-apis/README.md @@ -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 ```