# Referências

[block:api-header]
{
  "title": "Especificações da API"
}
[/block]

O Selling Partner API for Tokens fornece uma maneira segura de acessar as PII (informações de identificação pessoal) de um cliente. Você pode chamar a API de tokens para obter um token de dados restrito (RDT) para um ou mais recursos restritos que você especificar. O RDT autoriza chamadas subsequentes para operações restritas que correspondem aos recursos restritos que você especificou.

[block:embed]
{
  "html": false,
  "url": "https://github.com/amzn/selling-partner-api-docs/blob/main/references/tokens-api/tokens_2021-03-01.md",
  "title": "selling-partner-api-docs/tokens_2021-03-01.md at main · amzn/selling-partner-api-docs",
  "favicon": "https://github.com/favicon.ico",
  "image": "https://opengraph.githubassets.com/9265192769e3012c7b3241c81c3793f274ade6d87c5ee2de27068aa4fe1f35c2/amzn/selling-partner-api-docs"
}
[/block]

[block:api-header]
{
  "title": "Casos de uso"
}
[/block]

O Selling Partner API for Tokens (Tokens API) fornece uma maneira segura de acessar as informações de identificação pessoal (PII) de um cliente.

[block:embed]
{
  "html": false,
  "url": "https://github.com/amzn/selling-partner-api-docs/blob/main/guides/en-US/use-case-guides/tokens-api-use-case-guide/tokens-API-use-case-guide-2021-03-01.md",
  "title": "selling-partner-api-docs/tokens-API-use-case-guide-2021-03-01.md at main · amzn/selling-partner-api-docs",
  "favicon": "https://github.com/favicon.ico",
  "image": "https://opengraph.githubassets.com/9265192769e3012c7b3241c81c3793f274ade6d87c5ee2de27068aa4fe1f35c2/amzn/selling-partner-api-docs"
}
[/block]

A Selling Partner API for Tokens fornece uma maneira segura de acessar as PII (informações de identificação pessoal) de um cliente. Você pode chamar a API de tokens para obter um token de dados restrito (RDT) para um ou mais recursos restritos que você especificar. O RDT autoriza você a fazer solicitações subsequentes para acessar esses recursos restritos.

[block:api-header]
{
  "title": "Definições"
}
[/block]

### CreateRestrictedDataToken

O esquema de resposta para a operação getOrders.

Retorna um Restricted Data Token (RDT) para um ou mais recursos restritos que você especificar. Um recurso restrito é o método HTTP e o caminho de uma operação restrita que retorna informações de identificação pessoal (PII). Consulte o Guia de caso de uso da API de tokens para obter uma lista de operações restritas. Use o RDT retornado aqui como o token de acesso em chamadas subsequentes para as operações restritas correspondentes.

O caminho de um recurso restrito pode ser:

* Um caminho específico contendo um ID de pedido do vendedor, por exemplo `/orders/v0/orders/902-3159896-1390916/address`. O RDT retornado autoriza uma chamada subsequente para a operação getOrderAddress da API de pedidos somente para aquele pedido específico. Por exemplo, `GET /orders/v0/orders/902-3159896-1390916/address`.

* Um caminho genérico que não contém um ID de pedido do vendedor, por exemplo `/orders/v0/orders/{orderId}/address`. O RDT retornado autoriza chamadas subsequentes para a operação getOrderAddress para qualquer um dos IDs de pedido de um vendedor. Por exemplo, `GET /orders/v0/orders/902-3159896-1390916/address` e `GET /orders/v0/orders/483-3488972-0896720/address`.

[block:parameters]
{
  "data": {
    "h-0": "Valor",
    "h-1": "Descrição",
    "0-0": "Body\n\n**Obrigatório**\n\nTipo: [CreateRestrictedDataTokenRequest](#createrestricteddatatokenrequest)",
    "0-1": "Os detalhes da solicitação de token de dados restritos."
  },
  "cols": 2,
  "rows": 1
}
[/block]

[block:api-header]
{
  "title": "CreateRestrictedDataTokenRequest"
}
[/block]

O esquema de solicitação para a operação createRestrictedDataToken.

[block:parameters]
{
  "data": {
    "h-0": "Valor",
    "h-1": "Descrição",
    "0-0": "restrictedResources\n\n**Obrigatório**\n\nTipo: < [RestrictedResource ](#restrictedresource)> array",
    "0-1": "Uma lista de recursos restritos.\nMáximo: 50"
  },
  "cols": 2,
  "rows": 1
}
[/block]

[block:api-header]
{
  "title": "RestrictedResource"
}
[/block]

Modelo de recurso restrito.

[block:parameters]
{
  "data": {
    "h-0": "Valor",
    "h-1": "Descrição",
    "0-0": "method\n\n**Obrigatório**\n\nTipo: enum ([Method](#method))",
    "1-0": "path\n\n**Obrigatório**\n\nTipo: String",
    "0-1": "O método HTTP usado com o recurso restrito.",
    "1-1": "O caminho de uma operação restrita. Isto pode ser:\n\n* Um caminho específico contendo um ID de pedido do vendedor, por exemplo ```/orders/v0/orders/902-3159896-1390916/address```.\n\n* Um caminho genérico que não contém um ID de pedido do vendedor, por exemplo ```/orders/v0/orders/{orderId}/address```."
  },
  "cols": 2,
  "rows": 2
}
[/block]

[block:api-header]
{
  "title": "CreateRestrictedDataTokenResponse"
}
[/block]

O esquema de resposta para a operação createRestrictedDataToken.

[block:parameters]
{
  "data": {
    "h-0": "Valor",
    "h-1": "Descrição",
    "0-1": "Um Token de Dados Restritos (RDT). Este é um token de acesso de curta duração que autoriza você a acessar os recursos restritos que você especificou. Passe esse valor com o cabeçalho x-amz-access-token ao fazer chamadas subsequentes para esses recursos restritos.",
    "0-0": "restrictedDataToken\n\n**Obrigatório**\n\nTipo: String",
    "1-0": "expiresIn\n\nOpcional\n\nTipo: Integer"
  },
  "cols": 2,
  "rows": 2
}
[/block]

[block:api-header]
{
  "title": "Method"
}
[/block]

O método HTTP usado com o recurso restrito.

Tipo: enum

[block:parameters]
{
  "data": {
    "h-0": "Valor",
    "h-1": "Descrição",
    "0-0": "GET",
    "1-0": "PUT",
    "2-0": "POST",
    "3-0": "DELETE",
    "0-1": "O método GET.",
    "1-1": "O método PUT.",
    "2-1": "O método POST.",
    "3-1": "O método DELETE."
  },
  "cols": 2,
  "rows": 4
}
[/block]