Dash Replenishment Service (DRS) sample application shows how to integrate with Login With Amazon and how to call the Dash Replenishment Service APIs. Creating a DRS-enabled device requires you to become a part of our developer program and agree to the DRS terms and conditions, as well as other agreements, including our App Distribution and Services Agreement and the Login with Amazon Services Agreement. Learn more at developer.amazon.com.
In the sample application you can:
- Inspect all the DRS responses
- Inspect and modify the refresh and access tokens
- Obtain or manually enter slot IDs
- Call all the DRS APIs
The provided code mimics the DRS device with the model identifier 'ACN-S656-YXZ' and the companion Android application. The sample DRS device was created in Self-Service portal with two slots and a few ASINs in each slot, alongside with an LWA Security Profile and a default SNS Topic. The code can be logically split into two sections:
- Companion Application
- DRS Device
How to solve the communication between the companion application and the DRS device is out of the scope of this project, and we assume they can communicate over a secure channel.
The first three Activities in the application demonstrate a simple companion application where the user can enter the model ID and the serial number of the DRS device. The Composite ID, Random DSN button and is test device switch are here for testing purposes and they must not be present in the final application available to users.
The third activity will load the WebView which will display a DRS Teaser Page generated out of the composite ID.
In the next view, an LWA login page is presented. The following authorization and DRS setup workflow is owned and maintained by Amazon. The end user needs to authorize the LWA application security profile to perform operations on his behalf, and select what kind of product his device will purchase. Upon successful completion, the user is brought back to the DrsSampleAndroidApp. The last activity allows placing calls to DRS endpoints, mimicking a call from the DRS device, alongside with companion applications Login, Logout and Settings functionalities which are available in the application's menu.
After you complete the first steps and successfully login, the application mimic the behaviour of a DRS device. You can see how to call different DRS APIs and what their responses are. DRS APIs:
- Replenish
- Slot status
- Device status
- Subscription info
- Deregistration
- Cancel Test Order
- Get Order Info
Additional functionality of the companion app:
- Login - calls the login again
- Logout
- Settings - opens the consumable settings if you want to select a different product, change the shipping address or the payment method.
- Pull down the code locally.
- Open Android Studio and select 'Open an existing Android Studio Project'
- Navigate to checked out repository.
- Inside 'DrsSampleAndroidApp' folder select 'settings.gradle' file
- Run the application.
If you want to test your settings with the DrsSampleAndroidApp you will need to make some changes:
- In the
strings.xmlchange theDeviceGroupIdValue. - In the
Constants.javachange theCLIENT_ID. - Optional, in the
Constants.javachange theCOMPOSITE_IMAGE_ID. Amazon will provide you withCOMPOSITE_ID_VALUEonce you go through certification process on the Self-Service portal. - In the
assets/api_key.txtchange the APIKey. - In the
AndroidManifest.xmlchange thepackage. You will need to modify the package name in several other places. You need to modify package name because the API key is bound to the package name. - In the
AndroidManifest.xmlchange theandroid:host. - In the
build.gradlechange the signingConfigs to point to keystore used to create APIKey.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent