Package: pymfy
This library is an attempt to implement the entire Somfy API in Python 3.
Documentation for the Somfy API can be foundhere.Get developer credentialsVisthttps://developer.somfy.comCreate an accountOpen theMy AppsmenuAdd a new App (for testing, redirect url can be anything in https)Plug in your details into the test script below.Supported devicesSomfy currently exposes the following type of devices:BlindsRolling shuttersCamerasConnected ThermostatIf you find on thispagedevices not yet handle by this
repository, don't hesitate to open an issue.Installationpip install pymfyLimitationSomfy support sent the following message to third party applications using their API.Dear customer,

As you might have noticed, we have updated the quota policy of the Somfy Open API, in an ongoing effort to provide the best services to our users.

We are contacting you today to inform you about the new rules we are now applying to the API:
- First of all, no limitation will be applied on the POST /device/{deviceId}/exec endpoint as we want to provide you a total freedom on controlling your devices.
- On the other hand, polling frequency on the GET /site and child endpoints will now have to be under 1 call per minute.

To preserve an efficient and available service to any of our users, we want to keep the usage of the Open API to a usable but reasonable level to everybody. As we will keep monitoring the generated traffic and the potential impacts, be aware that we do reserve the rights to modify the authorized polling frequency or take any additional measure at any time as stated in our General Terms of Use.

Thank you for your understanding.Example usagePrint all covers position.importosimportjsonfromurllib.parseimporturlparse,parse_qsfrompymfy.api.devices.roller_shutterimportRollerShutterfrompymfy.api.somfy_apiimportSomfyApifrompymfy.api.devices.categoryimportCategoryclient_id=r"<CLIENT_ID>"# Consumer Keyredir_url="<REDIR_URL>"# Callback URL (for testing, can be anything)secret=r"<secret>"# Consumer Secretdefget_token():try:withopen(cache_path,"r")ascache:returnjson.loads(cache.read())exceptIOError:passdefset_token(token)->None:withopen(cache_path,"w")ascache:cache.write(json.dumps(token))cache_path="/optional/cache/path"api=SomfyApi(client_id,secret,redir_url,token=get_token(),token_updater=set_token)ifnotos.path.isfile(cache_path):authorization_url,_=api.get_authorization_url()print("Please go to{}and authorize access.".format(authorization_url))authorization_response=input("Enter the full callback URL")code=parse_qs(urlparse(authorization_response).query)["code"][0]set_token(api.request_token(code=code))site_ids=api.get_sites()devices=api.get_devices(site_ids[0],category=Category.ROLLER_SHUTTER)covers=[RollerShutter(d,api)fordindevices]forcoverincovers:print("Cover{}has the following position:{}".format(cover.device.name,cover.get_position()))ContributeThe currentdocumentationdoes not give enough information to implement all the devices.
If you want to contribute to this repository adding new devices, you can create an issue with the output of this script:importjsonimportrefromurllib.parseimporturlparse,parse_qsfrompymfy.api.somfy_apiimportSomfyApiclient_id=r"<CLIENT_ID>"# Consumer Keyredir_url="<REDIR_URL>"# Callback URL (for testing, can be anything)secret=r"<secret>"# Consumer Secretapi=SomfyApi(client_id,secret,redir_url)authorization_url,_=api.get_authorization_url()print("Please go to{}and authorize access.".format(authorization_url))authorization_response=input("Enter the full callback URL")code=parse_qs(urlparse(authorization_response).query)["code"][0]api.request_token(code=code)site_ids=[s.idforsinapi.get_sites()]devices=[api.get("/site/"+s_id+"/device").json()fors_idinsite_ids]# Remove personal informationdumps=json.dumps(devices,sort_keys=True,indent=4,separators=(",",": "))dumps=re.sub('".*id.*": ".*",\n',"",dumps)print(dumps)