Partilhar via

Configurar o acesso à API no Partner Center

  • Artigo

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

Este artigo descreve as contas de que precisas para desenvolver no 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.

Observação

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

Compreender as 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 são refletidos na sua fatura, e sua empresa é responsável por pagá-los.

Conta 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ê está conectado à conta de área restrita de integração aparecem na fatura, mas você não precisa pagar o valor da fatura. A fatura pdf contém uma declaração de exoneração de responsabilidade: "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. Não partilham contas de administrador, contas de utilizador, clientes, encomendas, subscrições ou outros dados.
  • O sandbox de integração suporta transações com um número limitado de clientes, pedidos, assinaturas, licenças e assim por diante.
  • As contas sandbox de integração são apenas para fins de teste de integração, em conformidade com a política.
  • Por padrão, não existe uma conta de área restrita 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 um ambiente de testes de integração

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

Habilitar 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. Inicie sessão no Partner Center com uma conta de administrador global e selecione Definições (ícone de engrenagem).
  2. Selecione Configurações de contae, em seguida, Gerenciamento de aplicativos.
  3. Se ainda não tiver uma aplicação existente, adicione uma nova aplicação Web. Se tiver uma aplicação web existente, escolha o botão Adicionar chave.
  4. Copie as informações de registo da aplicação, especialmente a chave de se estiver a criar uma aplicação Web, e armazene-a num local seguro.
  5. Saia do Painel de parceiros.
  6. 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ê precisa das seguintes informações para configurar a autenticação do Partner Center com uma identificação do Microsoft Entra.

  • ID do aplicativo / ID do cliente: listado como o ID do aplicativo registrado dentro de Configurações (ícone de engrenagem) >Configurações da conta>Gerenciamento de aplicativos.
  • Key: Se tu criaste uma nova aplicação web na secção anterior, usa essa chave.
  • Domain: É destinado à sandbox 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 usar seu código testado em sua conta de parceiro principal, você precisará de um token de segurança do Microsoft Entra. Este token de segurança é baseado no seu aplicativo Partner Center, chave e domínio (em vez do seu aplicativo sandbox de integração, chave e domínio).

  1. Siga as etapas em autenticação do Partner Center para obter um token de segurança do Microsoft Entra usando as 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.)
  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 principal.

Conteúdo relacionado