Pular para o conteúdo
StaurosAdmin Voltar para o site Entrar

Acesso à API

API de integração

Criar o token que liga o Stauros à contabilidade, a uma planilha ou a uma automação, e mandar a referência a quem vai integrar.

Ouvir este tutorial

A API deixa outro sistema ler e gravar dados do Stauros — a contabilidade buscando os lançamentos do mês, uma planilha puxando a lista de membros, uma automação cadastrando quem preencheu um formulário. Ela faz parte dos planos Integração Total e Sede.

O token

No menu da sua foto, Acesso à API. Cada sistema ganha o seu token, uma chave de acesso em seu nome:

A tela Acesso à API, com um token criado
  • Para que é — "Contabilidade", "Planilha da tesouraria": é o nome que você vai reconhecer na lista.
  • O que pode — Só ler ou Ler e gravar. Dê o mínimo: a contabilidade que só lê não precisa gravar.
  • Validade — de 30 dias a 1 ano, ou sem validade.

Ao criar, o token aparece uma vez só, com o botão de copiar. Guarde-o num lugar seguro e passe a quem vai configurar a integração. Se perder, revogue e crie outro.

🔒 O token vê e grava o mesmo que você. Ele usa as permissões do seu perfil, na sua igreja: se você não vê os dízimos, a integração também não vê. A lista mostra o último uso de cada token, e Revogar corta o acesso na hora. Trocar a sua senha, ou ter o usuário inativado, revoga todos os seus tokens.

A referência da API

Quem vai fazer a integração precisa saber o que pedir. O link Referência da API, na mesma tela, abre a página com cada rota do sistema — pessoas, financeiro, eventos, células, EBD, loja e o resto —, separadas por módulo na barra lateral, com os campos e um exemplo de pedido e de resposta. Quem usa o Postman baixa a coleção pronta na seção Postman da introdução:

A referência da API

A integração segue as mesmas regras das telas: o carnê nasce mês a mês, o dízimo só se altera pela ficha do membro, e o evento que vem da sede é só leitura na filial.