tapo-c210/secret-apis/README.md

1.3 KiB

Secret APIs

Tapo cameras provide undocumented APIs we can use to control them (simulating the use of their official app). You can download my Insomnia API collection at this link. The collection is not complete yet.

I am writing this collection also by giving a look at the code of the awesome project 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 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