Sandbox e clientes de teste

Cada associação pode ter um sandbox: uma associação gêmea com a mesma identidade visual, os mesmos tipos de carteirinha e o mesmo statuto, povoada de associados sintéticos. Ali você desenvolve e testa sem tocar em dados reais, e sem precisar de nenhuma aprovação.

Cada desenvolvedor convidado pela plataforma tem também um só seu, que não pertence a nenhuma associação: ele o cria, abre, recria e exclui em Configurações da conta › Desenvolvedor, e lá dentro registra os clientes de teste.

Como criá-lo

No console Desenvolvedores: o botão Criar sandbox, ou registre um cliente no ambiente Teste — o sandbox é criado quando necessário. Quem o cria se torna dirigente dele: pelo seletor de associações pode entrar nele e usar o back office com os dados sintéticos (aprovar um pedido, suspender uma carteirinha, …).

Os associados sintéticos

Seis contas, uma por status, com e-mail <state>@<slug>-sandbox.sandbox.invalid e uma senha compartilhada, mostrada uma vez na criação e a cada redefinição:

E-mail	Status	O que representa
attivo@…	ativa	carteirinha válida, statuto aceito — verdict: valid
in-attesa@…	pendente	pedido ainda não aprovado
sospeso@…	suspensa
revocato@…	revogada
scaduto@…	ativa, mas vencida	verdict: expired
statuto-da-accettare@…	ativa, statuto não aceito	verdict: statuto_required

Eles entram pela página de login normal do Vimine, então você pode testar o Entrar com Vimine de ponta a ponta: clique no seu site → login como attivo@… → consentimento → callback → API.

Dica

Para testar o pedido de adesão (membership:request) feito por alguém que ainda não é associado, entre com uma conta que não tem carteirinha naquele sandbox, por exemplo uma conta pessoal sua: o consentimento às permissões de adesão também é permitido a quem não é associado.

As pessoas que os seus testes criam

Quem se inscreve pela página de inscrição do sandbox, e quem um cliente de teste nomeia com /v1/signup ou /v1/enroll, vira uma pessoa sintética do sandbox: o endereço digitado é substituído por um do seu domínio (api-…@<slug>-sandbox.sandbox.invalid, sempre o mesmo para o mesmo endereço), que a página mostra no fim da inscrição. Nenhuma conta real é criada ou tocada, e nenhum e-mail é enviado.

Essas contas valem só no sandbox: entram ali com a senha escolhida, mas não podem se inscrever numa associação real, entrar em outra nem autorizar um cliente que não seja um cliente de teste do seu sandbox (sandbox_account).

Clientes de teste

Um cliente no ambiente Teste (vms_test_… para os confidenciais) fica vinculado ao sandbox, aparece no console da associação real, fica ativo na hora e emite tokens com mode: "test". Ele não pode tocar na associação real. Os e-mails do sandbox não são enviados.

Para ir para produção, registre um segundo cliente no ambiente Produção (com as mesmas URIs de redirecionamento https) e, depois que ele for ativado, troque o clientId na sua configuração: o código continua o mesmo.

Redefinição

Regenerar dados e credenciais no console, ou com um cliente de teste:

Node

import { VimineServer } from '@vimine/sdk/server';

const vimineServer = new VimineServer({ clientId: 'vmc_…', clientSecret: 'vms_test_…' });
await vimineServer.sandbox.members();                      // GET  /v1/sandbox
const { password } = await vimineServer.sandbox.reset();   // POST /v1/sandbox/reset — os associados recomeçam do zero, senha nova

A redefinição recria os seis associados sintéticos (consentimentos e sessões incluídos) e troca a senha deles; as pessoas criadas pelos seus testes são excluídas; os clientes e o sandbox continuam. Esses endpoints pedem o token de um cliente de teste confidencial (client_credentials), não HTTP Basic; um cliente de produção recebe 403.

Excluí-lo

Excluir sandbox no console Desenvolvedores (a diretoria, ou o operador da plataforma) o exclui na hora, com os associados sintéticos, as pessoas criadas pelos seus testes, os dados e os clientes de teste, que deixam de funcionar. Você pode criar um novo quando quiser.