Get Started with Alexa Smart Properties for Residential APIs
Before you can use Alexa Smart Properties for residential APIs, you must create an Amazon Business account, and then register it with Amazon. Then you must create a Login with Amazon (LWA) security profile by using the same Amazon Business account that you registered with Alexa Smart Properties for residential. Finally, you must register your LWA security profile with Alexa Smart Properties and use the security profile to generate an API access token.
Prerequisites
To create an Amazon Business account
- To create an Amazon Business account, go to Create an Amazon Business Account.
To register with Alexa Smart Properties for residential
- To register your Amazon Business account for Alexa Smart Properties for residential APIs, see Get Started with Alexa Smart Properties for hospitality and Alexa Smart Properties for residential. A member of the Alexa Business Development team will contact you to:
- Register your company's Amazon Business account e-mail or customer ID, business ID, and app client ID
Note: To find your business ID, log in to your Amazon business account, and then navigate to your account settings.
- Finalize pricing
- Finish setting up your subscription
- Give you your Alexa for Residential organization (
amzn1.alexa.unit.did.{id}
) identifier
- Register your company's Amazon Business account e-mail or customer ID, business ID, and app client ID
Create an LWA security profile
Create a security profile by following the steps in the LWA console, using the same Amazon Business account and email address that you registered with Alexa Smart Properties for residential. For future reference, make sure to note the client ID for your application. After creating your security profile, add your website to the security profile.
Integrate with LWA to get an API access token
To integrate LWA into your application to obtain an API access token, follow the instructions in Integrate LWA with your app. These instructions show you how to integrate LWA into your application and obtain an LWA API access token. For more information, see Authorization Code Grant.
To integrate with LWA to get an API access token for Alexa Smart Properties for residential
- Choose
Auth Code Grant
as your auth grant type. - Request the
"alexa::enterprise:management"
and"credential_locker::wifi_management"
scopes.
After you can successfully log in with Amazon by using your Amazon Business account, you can call Alexa Smart Properties for residential APIs.
To refresh your access token, follow the instructions in Using Refresh Tokens.
Use the LWA access token
To call the APIs, you must include your API access token as part of the Authorization request header of each API call.
The following example is a CURL request that uses the access token. To use it, change $ACCESS_TOKEN
to your real access token, and then change the URL to the correct one for the API you're calling.
curl -i -v -X GET -H "Authorization: Bearer $ACCESS_TOKEN" https://api.amazonalexa.com/v2/endpoints
Now that you've registered with Alexa Smart Properties for residential, you're ready to use its APIs. To learn how to set up admin roles for your users, see Managing Roles in Alexa Smart Properties for Residential.
Related topics
- About Alexa Smart Properties for Residential
- Managing Roles in Alexa Smart Properties for Residential
- Managing Homes, Communities, and Skills
- Alexa Smart Properties for Residential Device Purchase and Setup
Last updated: Dec 15, 2022