Compartilhar via

Configurar o acesso à API no Partner Center

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para Microsoft Cloud para o Governo dos EUA

Este artigo descreve as contas que você precisa desenvolver no SDK do Partner Center. Este artigo também explica como criar uma conta de ambiente de teste de integração e testar no ambiente de teste de integração.

Importante

A partir de 1º de abril de 2026, todo o uso de Aplicativos+Usuário de APIs do Partner Center imporá o uso da MFA.

Para ajudar a se preparar para esse requisito, a partir de outubro de 2025, as APIs procurarão o token MFA e fornecerão a confirmação de sua presença na resposta. Para obter mais informações, consulte Validando chamadas à API integradas com MFA.

Observação

Para obter acesso às APIs, seu locatário deve ser um locatário do CSP (Provedor de Soluções na Nuvem) e você deve ser um Provedor Indireto ou um parceiro de cobrança direta.

Entender as definições de conta

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

Conta de parceiro primário

Essa conta é onde você cria pedidos reais para clientes reais. Se você fizer alterações ou transações quando estiver conectado à conta primária, 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 são refletidos em sua fatura e sua empresa é responsável por pagar por elas.

Conta de área restrita de integração

Essa conta é 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ê está conectado à conta de área restrita de integração aparecem na fatura, mas você não precisa pagar o valor da fatura. O pdf da fatura contém um aviso de isenção de responsabilidade: "NÃO PAGAR. ESTA É UMA FATURA DE ÁREA RESTRITA E NÃO É NECESSÁRIA NENHUMA AÇÃO."

  • A conta sandbox de integração e a conta primária agem de forma independente. Eles não compartilham contas de administrador, contas de usuário, clientes, pedidos, assinaturas ou outros dados.
  • A área restrita de integração dá suporte a transações com um número limitado de clientes, pedidos, assinaturas, licenças e assim por diante.
  • As contas de sandbox de integração são destinadas exclusivamente a testes de integração por política.
  • Nenhuma conta de área restrita de integração existe por padrão. Você deve criar um por conta própria se planeja usar o SDK do Partner Center.

Configurar suas contas

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

Criar um sandbox de integração

Para criar uma área restrita de integração, siga as etapas em Criar uma conta de área restrita de integração do Provedor de Soluções na Nuvem (CSP).

Habilitar o acesso à API

Depois que sua conta for configurada, você deverá habilitar o acesso à API antes de poder usar o SDK do Partner Center com a área restrita de integração. Você precisa habilitar o acesso à API separadamente para sua conta de parceiro principal e sua conta de área restrita de integração.

  1. Entre no Partner Center com uma conta de administrador global e selecione Configurações (ícone de engrenagem).
  2. Selecione Configurações da conta e, em seguida, Gerenciamento de aplicativos.
  3. Se você ainda não tiver um aplicativo existente, adicione um novo aplicativo Web. Se você tiver um aplicativo Web existente, escolha o botão Adicionar chave.
  4. Copie as informações de registro do aplicativo, especialmente a chave se você estiver criando um aplicativo Web e armazene-as em um local seguro.
  5. Saia do Painel do Parceiro.
  6. Entre novamente com 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ê precisa das informações a seguir para configurar a autenticação do Partner Center com uma ID do Microsoft Entra.

  • ID do aplicativo/ID do cliente: listado como a ID do aplicativo registrado dentro de Configurações (ícone de engrenagem) >Configurações da conta>Gerenciamento de aplicativo.
  • Chave: se você criou um novo aplicativo Web na seção anterior, use essa chave.
  • Domínio: é para a área restrita de integração.

Executar código testado

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

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

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

Conteúdo relacionado

  • Last updated on