Conexões

Algumas fontes só respondem a uma pessoa com sessão iniciada. A SUNARP, por exemplo, exige um DNI peruano. Para essas fontes você registra sua própria conta uma vez como conexão, e cada consulta dessa fonte roda com ela.

​

Como se encaixa

A API que recebe suas credenciais pode guardá-las, mas não lê-las. Só o serviço isolado que faz login na fonte pode abri-las, e só para a consulta que precisa delas.

​

1. Registre uma conexão

authorized: true registra que você é o titular da conta ou tem a autorização do titular. A resposta nunca inclui as credenciais, só um nome mascarado.

​

2. Consulte

• Escolha. A Croma prefere a conexão cuja sessão já está aberta e depois a que tem mais cota. Envie connection_id para usar uma específica.
• Uma consulta por conta de cada vez. Consultas em contas diferentes rodam em paralelo; as de uma mesma conta esperam a vez, então nunca fazem login uma sobre a outra.
• Rodízio. Quando uma conta atinge sua cota diária, a mesma consulta passa para a sua próxima conexão. Registre mais de uma para ter mais capacidade.

​

Estados de uma conexão

GET /pe/sunarp/connections/v1 mostra o estado de cada conexão, os logins usados hoje e quando reinicia.

​

Segurança

• As credenciais são criptografadas assim que chegam à Croma e ficam vinculadas à sua organização: ninguém mais pode usá-las.
• Só o serviço isolado que faz login na fonte pode abri-las.
• A API nunca as devolve nem as mostra a ninguém, e elas nunca são gravadas em logs.
• Excluir uma conexão a destrói permanentemente.

​

A partir de um agente (MCP)

Os mesmos verbos são ferramentas do servidor MCP: sunarp_connect, sunarp_list_connections e sunarp_delete_connection. Um agente pode conectar a conta do usuário na conversa, com o consentimento dele, e depois consultar.