Uma API feita para o seu app ou site
Construímos a API que o seu app ou site consome, combinada com a sua equipe de front-end num contrato de API; a interface continua com ela.
Para quem é
Para empresas com equipe de app ou de front-end que espera o back-end para avançar.
O que resolve
- Uma tela precisa de várias chamadas à API e junta tudo no celular.
- O back-end muda um campo e o app em produção quebra.
- A equipe de front-end fica parada esperando a API ficar pronta.
- Versões antigas do app continuam instaladas e ninguém sabe o que elas ainda usam.
O que fazemos
- Contrato de API
- Endpoints, campos e erros combinados com a equipe de front-end antes do código, em OpenAPI ou GraphQL.
- Servidor simulado
- A equipe de front-end trabalha sobre respostas de exemplo enquanto a API real é construída.
- Camada por tela (BFF)
- Uma camada que junta várias fontes e devolve só o que cada tela precisa.
- Tipos gerados
- Tipos para TypeScript, Kotlin ou Swift gerados do contrato, para o app não adivinhar formatos.
- Versionamento
- Mudança incompatível entra em versão nova; versões antigas do app seguem funcionando pelo prazo combinado.
- Testes de contrato
- Cada publicação confere se o contrato com o app continua valendo, com testes automáticos.
O que você recebe
- Contrato de API versionado, revisado com a sua equipe de front-end
- Servidor simulado para o front-end trabalhar em paralelo
- API em produção, com autenticação e limites de uso
- Tipos gerados do contrato para as linguagens do seu app
- Testes de contrato rodando a cada publicação
Como fazemos
Telas e fluxos
Partimos das telas e dos fluxos que a sua equipe já desenhou.
Contrato
Endpoints, campos e erros escritos e aprovados pelos dois lados.
Desenvolvimento em paralelo
O front-end usa o servidor simulado enquanto o back-end implementa o contrato real.
Integração
O app troca o servidor simulado pela API real, em homologação.
Entrada em produção
API publicada junto com a versão do app, com plano de volta.
Exemplos de tecnologia
- OpenAPI
- GraphQL
- TypeScript
- Node.js
- Pact
- Redis
Serviços relacionados
Perguntas frequentes
E se ainda não temos equipe de front-end?
A Balkan não faz a interface nem o app, nem publica nas lojas. Nesse caso, a sua empresa contrata quem faça, e trabalhamos com essa equipe pelo contrato de API desde o começo.
Por que uma camada só para as telas?
Para que cada tela faça uma chamada só e receba apenas os dados de que precisa. Se o app é pequeno e a API atual já atende, a camada extra pode não compensar; isso se decide no contrato.
O app já existe e conversa com outra API. E agora?
Dá para colocar uma camada nova na frente da API atual e migrar tela por tela, sem obrigar todos os usuários a atualizar o app de uma vez.
O que precisamos ter pronto para começar?
As telas ou protótipos dos fluxos principais e alguém da equipe de front-end para revisar o contrato. O resto se define no mapeamento.
Escreva para a Balkan
Falar sobre o seu projeto