Chaves de API

Para o seu ERP, o seu site, um script seu — qualquer programa que precise ler ou escrever na Orian. Cada chave carrega só os escopos que você marcar, e você revoga quando quiser: ela para de valer no pedido seguinte. Ver a documentação da API.

Criar uma chave

NomeÉ como você vai saber qual revogar daqui a seis meses.

O que esta chave pode fazer

Ler contatoscontatos:lerGET /api/v1/contatosListar e abrir fichas. Inclui telefone e e-mail.Criar e atualizar contatoscontatos:escreverPOST /api/v1/contatosCriar ficha nova e mudar dados de ficha existente. Não apaga nem funde.Ler negóciosnegocios:lerGET /api/v1/negociosListar o funil, com valores e etapas.Criar e mover negóciosnegocios:escreverPOST /api/v1/negociosAbrir negócio e mover de etapa. Não apaga.Enviar mensagensmensagens:enviarrisco altosem endpoint aindaEnfileirar WhatsApp e e-mail para contatos. Respeita opt-out e o ritmo do canal.Registrar vendasvendas:escreverrisco altoPOST /api/v1/vendasA loja avisa o pedido pago. Cria o contato e o negócio ganho, e dispara os fluxos de venda.Registrar eventoseventos:escreverPOST /api/v1/eventosMandar evento de site ou de sistema para a linha do tempo do contato.

Sem banco conectado

Chaves de verdade precisam de banco. Uma chave de mentira daria acesso a nada e apareceria como erro de autenticação no seu programa — pior que não existir.

Como usar

Mande a chave no cabeçalho Authorization:

curl https://seu-tino.app/api/v1/contatos \
  -H "Authorization: Bearer tino_sua_chave_aqui"

Hoje existe um endpoint: GET /api/v1/contatos. Os outros entram um a um, cada um com o escopo dele — a autenticação e os escopos já valem para todos.

O que a Orian faz com a sua chave

· Guarda só o resumo criptográfico dela. Nem nós conseguimos ler o valor depois de gerar — por isso ele aparece uma vez só.
· Registra quando ela foi usada pela última vez. É como você reconhece uma chave esquecida num servidor antigo.
· Respeita os escopos, sem herança. Uma chave que escreve contatos não lê contatos — se você precisa dos dois, marque os dois.