Introdução a API

O que é a API de tokens?

A Selling Partner API for Tokens (Tokens API) fornece uma maneira segura de acessar as informações de identificação pessoal (PII) 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 chamadas subsequentes para as operações restritas que os recursos restritos representam. Para obter as definições, consulte Terminologia.

Ao chamar uma operação restrita, você inclui um RDT no cabeçalho x-amz-access-token. Isso está em contraste com outras operações SP-API, onde você inclui um token de acesso LWA no cabeçalho x-amz-access-token. Para obter mais informações, consulte a Etapa 3. Adicionar cabeçalhos ao URI no Selling Partner API Developer Guide.

Termos usados

  • Restricted Data Token (RDT): Um token de acesso de curta duração que autoriza você a chamar operações restritas.

  • Restricted operation: Uma operação que retorna dados restritos, como informações de identificação pessoal (PII). Você precisa de um RDT para chamar uma operação restrita.
    Consulte Operações restritas.

  • Restricted resource: Um método e caminho HTTP que representa uma operação restrita.

  • Restricted report type: A report type that contains PII. See Restricted report types

  • Specific path: Um caminho em um recurso restrito que contém um pedido específico ou identificador de envio. Por exemplo, orders/v0/orders/902-3159896-1390916/address

  • Generic path: Um caminho em um recurso restrito que contém um identificador genérico, tal como {orderId} ou {shipmentId}. Por exemplo orders/v0/orders/{orderId}/address