Postman

O Postman pode importar o contrato oficial diretamente da SuperSign. Assim, a coleção acompanha os endpoints e schemas publicados sem manter uma cópia manual.

Importar

No Postman, selecione Import.

Escolha Link.

Informe https://api.sandbox.supersign.com.br/openapi.json.

Confirme a criação da coleção.

Crie a variável de coleção baseUrl com o valor https://api.sandbox.supersign.com.br.

Configure a autenticação Bearer da coleção com uma variável secreta apiKey contendo sua chave ss_test_....

Não salve a chave como valor inicial, não sincronize o valor atual com um workspace público e não exporte a coleção com credenciais.

Homologar no Sandbox

Comece por GET /v4/api/me. A resposta deve indicar environment: sandbox. Depois execute o fluxo descrito em Primeiro envelope em 5 minutos.

As operações POST exigem Idempotency-Key. Use uma variável dinâmica ou um identificador estável da operação de negócio; durante retries da mesma intenção, preserve o mesmo valor.

Passar para Produção

Após homologar:

altere baseUrl para https://api.sign.supersign.com.br;

substitua a credencial por uma chave ss_live_...;

mantenha rotas, corpos e tratamento de respostas sem alteração.

Uma chave de Sandbox nunca deve ser aceita em Produção, e uma chave de Produção nunca deve ser aceita no Sandbox.

Testar a API no Postman

Postman#

Importar#

Homologar no Sandbox#

Passar para Produção#

Postman

Importar

Homologar no Sandbox

Passar para Produção