Saltar para o conteúdo principal
O SalesOS tem dois ambientes. Os dois rodam a mesma API — mesmos endpoints, ações, campos e erros — com dados e chaves separados.
Chave nunca atravessa ambiente. Uma sk_live_ enviada a Staging, ou uma sk_test_ enviada a Produção, recebe 401 com code: "api_key_not_found".

O ambiente é escolhido pela URL base

Só a URL base muda. Caminhos, corpos e assinaturas são idênticos; por isso, URL base e chave ficam na configuração, nunca no código:
Todos os exemplos desta documentação usam a URL de produção. Para rodar em Staging, troque https://api.play2sell.com por https://api-staging.play2sell.com e use uma chave sk_test_.
A assinatura cobre o caminho, não o host: o mesmo pedido assinado vale no outro ambiente só com a chave daquele ambiente. Nunca reaproveite chave de produção em ferramenta de teste.

Uma chave para cada ambiente

1

Staging

Peça ao seu contato na Play2sell acesso a uma empresa de teste em Staging. Depois, em https://app-staging.play2sell.com, vá em Admin > Integrações > Chaves de API e crie uma chave com os escopos que a integração usa. Ela começa com sk_test_.
2

Produção

Quando a integração passar na lista abaixo, um admin da sua empresa cria a chave em https://app.play2sell.com, no mesmo menu e com os mesmos escopos. Ela começa com sk_live_.
O segredo aparece uma única vez, na criação da chave. Guarde num cofre de segredos.

O que testar em Staging

Lista para entrar no ar

  • URL base e chave vêm da configuração; nada de ambiente no código
  • Uma chave sk_live_ só com os escopos usados
  • Segredo num cofre de segredos, fora do repositório e dos logs
  • Relógio do servidor sincronizado (a assinatura vale por 30 segundos)
  • Novas tentativas com espera progressiva em 429 e 5xx; escritas com idempotency_key
  • O ID de cada resposta registrado no log (meta.request_id, ou instance nos erros de Pagamentos), para o suporte achar qualquer chamada
  • Endpoint de webhook em produção com https://, público, conferindo a assinatura e respondendo 2xx rápido
  • As primeiras chamadas em produção acompanhadas por um dia

Boas práticas

  • Escrita se testa em Staging. Explorar com leitura em produção é tranquilo; experimentar escrita, não.
  • Dado de teste fica em Staging. Não copie dados de pessoas reais para Staging.
  • Versão nova aparece primeiro em Staging. Se algo muda, você vê lá antes de chegar à produção.