API de Programador & Webhooks

Mais cedo ou mais tarde, todo o negócio de aluguer sério precisa de inserir ou extrair dados programaticamente — um cliente corporativo quer um feed, uma ferramenta de BI quer os números, um script interno precisa de criar encomendas.

A Renttix disponibiliza uma API REST versionada exatamente para isso. Clientes, encomendas, produtos e os outros recursos principais estão disponíveis através de endpoints JSON limpos em /api/v1, com documentação servida a partir da própria plataforma em vez de um PDF de duas versões atrás.

O acesso é feito através de chaves API que cria e gere no portal do programador. As chaves podem ser revogadas instantaneamente, e cada chave está restrita ao seu espaço de trabalho — não há credenciais master a vaguear no portátil de um contratante.

Os limites de taxa (rate limits) e os registos (logs) estão incorporados na mesma camada que a sua própria interface utiliza, pelo que o tráfego da API é governado e observável em vez de ser uma porta lateral.

As integrações que fazem polling (consultas periódicas) à procura de alterações são lentas quando precisa delas rapidamente e desperdiçam recursos o resto do tempo. Os webhooks invertem a relação: a Renttix informa os seus sistemas no momento em que algo acontece.

Registe endpoints de webhook para os eventos que lhe interessam e os seus sistemas recebem um payload assinado quando estes são acionados — uma encomenda criada a partir do seu site pode chegar ao seu CRM antes do email de confirmação chegar ao cliente.

Os endpoints são geridos juntamente com as suas chaves API no portal do programador, e cada entrega é registada para que uma mensagem perdida seja uma consulta, não um mistério.

Juntamente com a API, os webhooks fazem da Renttix uma plataforma na qual constrói, em vez de uma caixa de onde copia dados. O sistema de registo mantém-se como sistema de registo, e tudo o resto mantém-se sincronizado.

Toda a integração acaba por ter a sua pergunta das 3 da manhã: o que é que o sistema recebeu exatamente, e o que respondeu?

O portal do programador mantém registos de pedidos para o tráfego da API — o que foi chamado, por qual chave, com que resultado — para que depurar uma integração seja ler um registo, não reconstruir eventos a partir de ambas as extremidades de uma chamada telefónica.

A mesma disciplina aplica-se às próprias ligações de saída da plataforma. Sincronizações de contabilidade, chamadas a fornecedores de pagamentos e entregas de webhooks são registadas, dando-lhe um rastro de papel em todas as fronteiras do sistema.

Para empresas com equipas de desenvolvimento, esta é a diferença entre um fornecedor e uma plataforma: a maquinaria é inspecionável, as credenciais são suas para rodar, e os dados são acessíveis no momento em que precisa deles noutro lugar.