Account Linking Operations (Skill Management API), v0
Warning: You are viewing the SMAPI v0 API documentation. The current version of SMAPI is Version 1. Switch to v1 to view the latest documentation.
This document describes all API operations related to linking Alexa user accounts to other OAuth identity providers. Each request must have an Authorization header whose value should be the access token retrieved from Login with Amazon.
See also: Alexa Skills Kit Command Line Interface and Alexa Skill Management API Overview
Update Account Linking
Request
PUT /v0/skills/{skillId}/accountLinkingClient
{
"accountLinkingRequest": {
"type": "AUTH_CODE",
"authorizationUrl": "string",
"domains": [
"string"
],
"clientId": "string",
"scopes": [
"string"
],
"accessTokenUrl": "string",
"clientSecret": "string",
"accessTokenScheme": "HTTP_BASIC",
"defaultTokenExpirationInSeconds": integer
}
}
Parameter Description
| Field | Description | Parameter Type | Required? |
|---|---|---|---|
| skillId | Unique identifier of skill. | Path | Yes |
Body Description
Contains an accountLinkingRequest object. See Account Linking Schema.
Response
HTTP/1.1 204 No Content
Read Account Linking Info
Request
GET /v0/skills/{skillId}/accountLinkingClient
Parameter Description
| Field | Description | Parameter Type | Required? |
|---|---|---|---|
| skillId | Unique identifier of skill. | Path | Yes |
Response
HTTP/1.1 200 OK
{
"accountLinkingResponse": {
"clientId": "abc",
"authorizationUrl": "https://www.example.com/auth_url",
"accessTokenUrl": "https://www.example.com/accessToken_url",
"domains": [
"www.example.com"
],
"scopes": [
"scope_a",
"scope_b"
],
"accessTokenScheme": "HTTP_BASIC",
"type": "AUTH_CODE"
}
}