O que é API aberta

API aberta é uma interface de comunicação entre sistemas cuja documentação é pública e acessível: qualquer equipe técnica autorizada pelo órgão consegue conectar outro sistema ao processo eletrônico sem depender de desenvolvimento exclusivo do fornecedor. Para uma prefeitura, câmara ou autarquia, isso significa que o sistema de tramitação, o sistema financeiro e outras bases trocam dados por regras conhecidas, e não por digitação manual ou por contratos de integração fechados.

API aberta na prática

No dia a dia de um órgão público, a API aberta aparece quando um processo precisa de um dado ou de uma ação que mora em outro sistema. O caso mais comum é a cobrança: o processo chega a uma etapa em que uma taxa é devida, o sistema de tramitação pede ao sistema financeiro a emissão da guia e recebe de volta o documento e, depois, a confirmação do pagamento. O servidor não troca de tela nem redigita número de inscrição.

O que torna a interface “aberta” não é a ausência de controle de acesso. É o fato de que as regras de uso estão documentadas e disponíveis. Cada integração continua exigindo credencial, permissão e registro de quem consultou o quê.

API aberta × integração sob medida

A confusão mais frequente na contratação é tratar toda integração como equivalente. Na integração sob medida, o fornecedor desenvolve uma ponte específica entre dois sistemas, e qualquer mudança de regra volta a depender dele e de nova negociação. Na API aberta, a ponte é construída sobre um contrato técnico público, e a equipe de TI do órgão, ou de outro fornecedor, consegue ajustar ou criar novas conexões.

Há também a API fechada, disponível apenas para parceiros homologados ou sob condições comerciais restritivas. Ela existe, mas transfere ao fornecedor o controle sobre quem integra e quando. A pergunta útil na hora de avaliar uma plataforma é: se o sistema financeiro for trocado daqui a dois anos, a integração precisa ser refeita pelo mesmo fornecedor ou pode ser refeita pelo próprio órgão?

Sobre custo e modelo de contratação, veja melhores modelos de cobrança de integração via API para instituições públicas.

Casos de uso comuns

• Emissão de guia de taxa ou tributo a partir de um processo de licenciamento, sem relançamento manual no sistema financeiro. Veja como integrar o processo eletrônico ao sistema tributário para gerar guia automática.
• Consulta de débito do contribuinte antes de liberar um documento, como a renovação de um alvará.
• Troca de andamento entre o portal de atendimento e um sistema de tramitação já existente. Veja como integrar o protocolo eletrônico ao SEI.
• Busca de dados cadastrais em bases externas durante o preenchimento do formulário, evitando que o requerente digite o que já está registrado em outro lugar.
• Devolução do status de um processo a um sistema de terceiros, como o de um consórcio intermunicipal.

O que a legislação diz

A Lei nº 14.129/2021, a Lei do Governo Digital, orienta a administração pública a oferecer serviços digitais com integração entre sistemas e reaproveitamento de dados, para que o cidadão não precise informar de novo o que o poder público já possui. A API aberta é um dos meios técnicos para cumprir esse princípio.

Quando a integração envolve dados pessoais, a Lei nº 13.709/2018 (LGPD) também se aplica. O art. 26 trata do uso compartilhado de dados pelo poder público e exige que ele atenda a finalidades específicas de execução de políticas públicas. Por isso, cada conexão deve ter finalidade definida, credencial própria e trilha de auditoria.

Como o Aprova aplica API aberta

• A documentação da API do Aprova é aberta e pública, e a equipe de TI do órgão pode integrar sistemas sem depender de desenvolvimento sob medida.
• A integração com o sistema financeiro do município permite emitir a taxa no sistema de arrecadação e trazer a guia para dentro do processo.
• O marketplace de integrações reúne conexões prontas, como a consulta a bases do IBGE durante o preenchimento do formulário.
• O processo eletrônico mantém o histórico de cada etapa, o que inclui as ações disparadas por integração.

FAQ sobre API aberta

API aberta significa que qualquer pessoa pode acessar os dados do órgão?

Não. A documentação é pública, mas o acesso aos dados exige credencial e permissão. A abertura se refere às regras de uso da interface, não à exposição das informações do município.

O órgão precisa de equipe de TI própria para usar uma API aberta?

Uma equipe de TI facilita a criação de novas integrações, mas não é obrigatória para usar as que já existem. Quando o fornecedor entrega conexões prontas, a equipe interna entra apenas para integrações específicas, como a ligação com um sistema financeiro legado.

Integrar com o sistema financeiro exige trocá-lo?

Não. A lógica é justamente manter o sistema financeiro em operação e conectá-lo ao processo eletrônico. A guia é emitida no sistema de arrecadação e acompanhada dentro do processo, sem substituir a base tributária existente.

Como saber se a API do fornecedor é de fato aberta?

Verifique se a documentação técnica pode ser consultada sem acordo comercial prévio, se o contrato prevê uso sem cobrança por chamada e se outro fornecedor ou a TI do órgão consegue construir uma integração com ela. Se a resposta for não para os três pontos, a interface é fechada, mesmo que o fornecedor a chame de aberta.

Conclusão

A API aberta decide quem controla as conexões do órgão ao longo do contrato: o fornecedor ou a própria gestão. Ao avaliar uma plataforma, peça a documentação da API antes de assinar e teste uma integração real, como a emissão de guia a partir de um processo. Para ver como isso funciona no Aprova, agende uma demonstração.