Visão geral da API

Endereço base, formato das requisições e respostas, e o padrão de erro da API do Modari.

A API do Modari permite que sistemas externos iniciem conversas e acompanhem o que acontece com os leads. Ela é REST, aceita e devolve JSON.

Esta referência é escrita à mão a partir dos contratos reais da API. Não é um dump de especificação — o que está aqui é o que uma integração precisa saber para funcionar.

Endereço base#

https://moveis-api.smarktech.app.br/api

Todos os caminhos desta seção são relativos a esse endereço.

Formato#

Requisições com corpo usam Content-Type: application/json.
Respostas são sempre JSON, inclusive as de erro.
Datas seguem ISO 8601 em UTC.
Números de telefone seguem o formato 55DDDNNNNNNNN — código do país, DDD e o número, só dígitos.

Autenticação#

Toda requisição precisa de uma API key no cabeçalho Authorization. Ver Autenticação.

Respostas#

Toda resposta traz o campo status com o código HTTP repetido no corpo:

{
  "status": 201,
  "success": true
}

Erros#

Código	Quando acontece
`400`	O corpo não passou na validação. A mensagem diz qual campo e por quê.
`401`	API key ausente, inválida, revogada, ou usada em um endpoint que não aceita API key.
`404`	O recurso referenciado no corpo não existe para a sua empresa.
`500`	Falha interna. Pode ser repetida com segurança depois de alguns segundos.

Formato do erro:

{
  "status": 400,
  "message": "O campo destination deve estar no formato 55XXXXXXXXXXX"
}

Isolamento por empresa#

A API key identifica a empresa. Todo recurso lido ou criado pertence à empresa da key — não é possível alcançar dados de outra empresa passando um ID de outra conta: o recurso simplesmente não é encontrado.