Add grab-locks-from-api: extract lock secrets via TTLock management API

[nsleigh]

Thanks for sharing this code, I was concerned about not having local control of the lock and now I have it. As I didn't have an Android I had to use another method to get the keys - with the help of Claude (and your code) I created a script to run against the API and thought I'd share it.

NOTE: this is an update to the previous PR with "grad" renamed to "grab".

Summary

• Adds a new grab-locks-from-api/ directory with a Python script to extract lock secrets (MAC address, AES key, admin_ps, unlock_key) from the TTLock management API
• No rooted device required — uses TTLock developer API credentials instead of the app database
• Credentials are loaded from a gitignored .env file to avoid accidental secret commits

Details

The script authenticates via OAuth to the TTLock API and retrieves all lock keys associated with the account. It decodes the aesKeyStr, adminPwd, and lockKey fields using the same TABLE-based XOR algorithm as grab-locks-from-app/db2locks.py, producing values ready for use in ESPHome secrets.yaml.

Output

===== Hardware Found: XXNNN_ffeedd =====
MAC Address             : AA:BB:CC:DD:EE:FF
Lock ID (lock_id)       : 12345678
AES Key (lock_key)      : __aes_key_32_characters__
Admin PS (admin_ps)     : 0x11111111
Unlock Key (unlock_key) : 0x88888888
=============================================

🤖 Generated with Claude Code