Set up API access in Partner Center (Configurar o acesso da API no Centro de Parceiros)

Artigo
11/27/2023

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center for Microsoft Cloud for US Government

Este artigo descreve as contas que você precisa desenvolver em relação ao SDK do Partner Center. Este artigo também explica como criar uma conta de sandbox de integração e testar na sandbox de integração.

Nota

Para obter acesso a APIs, seu locatário deve ser um locatário CSP e você deve ser um provedor indireto ou um parceiro de cobrança direta.

Definições de conta

Para ajudá-lo a integrar e testar sua integração de API, o Partner Center oferece suporte a dois tipos de contas:

Conta de parceiro principal

Esta conta é onde você cria pedidos reais para clientes reais. Se você fizer alterações ou transações quando estiver conectado à conta principal, usando o SDK do Partner Center ou a interface do usuário do Painel de Parceiros, elas serão tratadas como pedidos oficiais para clientes reais. Eles serão refletidos na sua fatura, e sua empresa é responsável por pagá-los.

Conta de sandbox de integração

Essa conta serve para testar seu código e sua integração com as APIs do Partner Center antes de implantá-lo amplamente. As alterações e transações feitas quando você estiver conectado à conta sandbox de integração aparecerão na sua fatura, no entanto, você não precisa pagar o valor da fatura. A fatura pdf terá uma declaração de exoneração de responsabilidade como "NÃO PAGUE. ESTA É UMA FATURA SANDBOX E NENHUMA AÇÃO É NECESSÁRIA."

A conta sandbox de integração e a conta principal atuam de forma independente e não compartilham contas de administrador, contas de usuário, clientes, pedidos, assinaturas ou outros dados.

O sandbox de integração suporta transações com um número limitado de clientes, pedidos, assinaturas, licenças, etc.

Por política, as contas de área restrita de integração são apenas para fins de teste de integração.

Por predefinição, não existe nenhuma conta de sandbox de integração. Você mesmo deve criar um se planeja usar o SDK do Partner Center.

Configurar as suas contas

Esta seção descreve como configurar uma conta de parceiro principal e uma conta de área restrita de integração para o SDK do Partner Center.

Criar uma área restrita de integração

Inicie sessão no Partner Center com uma conta de administrador global e selecione Definições (engrenagem).

Nota

A criação de uma Sandbox requer que o administrador global do parceiro esteja conectado ao Partner Center com seu alias de domínio onmicrosoft.com (por exemplo, alias@domain.onmicrosoft.com). A criação da área restrita falhará se o usuário estiver conectado com seu domínio personalizado.
Selecione Configurações da conta e, em seguida , Área restrita de integração.

Nota

Se não vir uma opção de sandbox de integração, poderá não ter uma conta de administrador global. Você também pode estar usando uma conta de sandbox de integração e uma sandbox de integração já foi configurada.
Insira as informações de contato para a conta de administrador da área restrita de integração. Em seguida, escolha Criar conta. Aguarde alguns minutos por uma mensagem de confirmação de que a conta foi criada.
Depois de ver a mensagem de confirmação, saia do Painel de parceiros.
Inicie sessão novamente com a sua nova conta de administrador da área restrita de integração. Certifique-se de usar o formato username@domain para suas credenciais junto com a senha que você especificou.
Escolha Configurar conta na página Área restrita de integração para concluir a configuração da conta de área restrita.

Habilitar acesso à API

Quando a sua conta estiver configurada, tem de ativar o acesso à API para poder utilizar o SDK do Centro de Parceiros com o sandbox de integração. Precisa de ativar o acesso à API separadamente para a sua conta de Parceiro principal e a conta de sandbox de integração.

Inicie sessão no Partner Center com uma conta de administrador global e selecione Definições (engrenagem).
Selecione Configurações da conta e, em seguida , Gerenciamento de aplicativos.
Se ainda não tiver uma aplicação existente, adicione uma nova aplicação Web. Se você tiver um aplicativo Web existente, escolha o botão Adicionar chave .
Copie as informações de registo da aplicação, especialmente a Chave se estiver a criar uma aplicação Web, e armazene-a num local seguro.
Saia do Painel de parceiros.
Inicie sessão novamente com a sua conta sandbox de integração. Repita as etapas 2 a 5 para habilitar o acesso à API na área restrita de integração.

Escrever e testar código

Você pode escrever código e testar código na área restrita de integração. Você precisará das seguintes informações para configurar a autenticação do Partner Center com a ID do Microsoft Entra.

Nome do item	Localização do artigo
ID do aplicativo / ID do cliente	Em Configurações (engrenagem), selecione Configurações da conta e, em seguida , Gerenciamento de aplicativos. O ID do aplicativo/ID do cliente é listado como o ID do aplicativo registrado.
Key	Se você criou um aplicativo Web na seção Habilitar acesso à API, essa é a chave salva na etapa 5.
Domínio	O domínio para a área restrita de integração.

Executar código testado

Para usar sua solução com dados reais de clientes, você deve mudar de suas credenciais de área restrita de integração para suas credenciais de conta de parceiro principal.

Quando estiver pronto para utilizar o código testado na sua conta de Parceiro principal, tem de obter um token de segurança do Microsoft Entra. Esse token de segurança é baseado no aplicativo, na chave e no domínio do Partner Center (em vez do aplicativo, da chave e do domínio da área restrita de integração).

Siga as etapas em Autenticação do Partner Center para obter um token de segurança do Microsoft Entra usando suas credenciais principais do Partner Center. (Você seguiu anteriormente estas etapas para obter um token de segurança do Microsoft Entra para sua área restrita de integração.)
Substitua o token de segurança de integração em seu código pelo novo token de segurança para sua conta de parceiro principal.