与 Husqvarna Automower API 通信的模块
项目描述
自动割草机
与 Automower Connect API 通信的异步库
REST API 示例
from aioautomower import GetAccessToken, GetMowerData, Return
from aiohttp import ClientError
from aiohttp.client_exceptions import ClientConnectorError
import asyncio
api_key = "12345678-abcd-1234-a1a1-efghijklmnop" ## Your API-Key
client_secret = "client_secret" ## Your client_secret
class ExampleToken:
"""Returns the access token as dict."""
def __init__(self, api_key, client_secret):
self.client_id = api_key
self.client_secret = client_secret
async def token(self):
try:
get_token = GetAccessToken(
self.client_id,
self.client_secret,
)
access_token_raw = await get_token.async_get_access_token()
except (ClientConnectorError, ClientError):
raise KeyError
return access_token_raw
class MowerData:
"""Returns the data of all mowers as dict."""
def __init__(self, api_key, access_token, provider, token_type):
self.api_key = api_key
self.access_token = access_token
self.provider = provider
self.token_type = token_type
async def mowers(self):
try:
get_mower_data = GetMowerData(
self.api_key,
self.access_token,
self.provider,
self.token_type,
)
mower_data = await get_mower_data.async_mower_state()
except (ClientConnectorError, ClientError):
return "Make sure, you are connected to the Authentication API and the Automower API"
return mower_data
class SendingCommand:
"""Returns the data of all mowers as dict."""
def __init__(self, api_key, access_token, provider, token_type, mower_id, payload, command_type):
self.api_key = api_key
self.access_token = access_token
self.provider = provider
self.token_type = token_type
self.mower_id = mower_id
self.payload = payload
self.command_type = command_type
async def mowers(self):
try:
send = Return(
self.api_key,
self.access_token,
self.provider,
self.token_type,
self.mower_id,
self.payload
self.command_type
)
send = await send.async_mower_command()
except Exception:
return "Something went wrong"
return send
example = ExampleToken(api_key, client_id)
token_output = asyncio.run(example.token())
print(token_output)
access_token = token_output["access_token"]
provider = token_output["provider"]
token_type = token_output["token_type"]
example2 = MowerData(api_key, access_token, provider, token_type)
mower_output = asyncio.run(example2.mowers())
print(mower_output)
mower_id = mower_output["data"][0]["id"] ## '0' is your first mower
print ("Mower ID:", mower_id)
command_type = "actions"
payload = '{"data": {"type": "ResumeSchedule"}}' ## For more commands see: https://developer.husqvarnagroup.cloud/apis/Automower+Connect+API#/swagger
example3 = SendingCommand(api_key, access_token, provider, token_type, mower_id, payload, command_type)
result = asyncio.run(example3.mowers())
print (result) ## if, 202, then okay
AutomowerSession 示例
AutomowerSession 跟踪访问令牌，在需要时刷新它并监视 websocket 的更新，其数据被发送到用户提供的回调。
import asyncio
import logging
import aioautomower
CLIENT_SECRET = "mystringpassword"
API_KEY = "12312312-0126-6222-2662-3e6c49f0012c"
async def main():
sess = aioautomower.AutomowerSession(API_KEY, token=None)
# Add a callback, can be done at any point in time and
# multiple callbacks can be added.
sess.register_cb(lambda data:print(data))
# If no token was passed to the constructor, we need to call login()
# before connect(). The token can be stored somewhere and passed to
# the constructor later on.
token = await sess.logincc(CLIENT_SECRET)
if not await sess.connect():
# If the token is still None or too old, the connect will fail.
print("Connect failed")
return
await asyncio.sleep(5)
status = await sess.get_status()
print(status)
await asyncio.sleep(30)
# The close() will stop the websocket and the token refresh tasks
await sess.close()
asyncio.run(main())
AutomowerCLI 示例
在 CLI 中为您提供数据的 AutomowerSession
automower --client_secret 12312312-12ec-486b-a7a7-9d9b06644a14 --api-key 12312312-0126-6222-2662-3e6c49f0012c
下载文件
下载适用于您平台的文件。如果您不确定要选择哪个，请了解有关安装包的更多信息。
源分布
aioautomower-2022.9.0.tar.gz
（10.8 kB
查看哈希）
内置分布
aioautomower-2022.9.0-py3-none-any.whl
（11.3 kB
查看哈希）
关
