Em estudo

A API do MOZinONE App.

Uma forma de usar as empresas, categorias e reservas do MOZinONE App dentro do seu site, aplicação ou sistema interno.

Esta API ainda não existe.

Estamos a medir o interesse antes de a construir. Se houver procura real, entra no plano com data.

Dizer o que preciso Ver a proposta

Porque perguntamos em vez de anunciar

Honestidade primeiro.

Construir e manter uma API pública é trabalho a sério — documentação, chaves, versões, suporte. Não queremos gastar meses nisso para depois ninguém usar.

Se houver procura real, avançamos. Se não houver, dizemos que não — e ficamos os dois a ganhar.

Uma proposta, não uma promessa.

O que faria sentido na primeira versão

Uma proposta, não uma promessa.

Diga-nos o que falta ou o que sobra. Isto é o ponto de partida que nos parece mais útil.

Pesquisar empresas

Pesquisa por nome, categoria, localização ou província — os mesmos filtros que existem no site.

GET/api/v1/search?q=restaurante&city=maputo

Detalhes de uma empresa

Nome, endereço, horário, contactos, fotos e serviços — tudo o que a ficha da empresa tem.

GET/api/v1/listings/1234

Avaliações

À medida que os clientes forem avaliando, as pontuações ficariam disponíveis aqui. Hoje ainda não temos avaliações.

GET/api/v1/reviews/1234

Reservas

Criar marcações a partir do seu sistema, usando o motor de reservas do MOZinONE App — com aviso por WhatsApp incluído.

POST/api/v1/bookings

Categorias e localizações

A lista completa de categorias de negócio e de localizações, para alimentar os filtros do seu sistema.

GET/api/v1/categories

Autenticação

Uma chave por parceiro, pedidos sempre por HTTPS, e limites de utilização claros para ninguém ficar sem serviço.

HEADERX-API-Key: sua_chave_aqui

Como seria uma resposta

Dados limpos, estruturados e prontos a usar.

GET/api/v1/listings/1234

{
  "id": 1234,
  "nome": "Restaurante Exemplo, Lda",
  "categoria": "Restaurantes",
  "cidade": "Maputo",
  "endereco": "Av. Exemplo, 123",
  "telefone": "+258 84 000 0000",
  "horario": {
    "seg_sex": "09:00 - 22:00",
    "sabado": "10:00 - 23:00",
    "domingo": "fechado"
  },
  "rating": null,
  "total_avaliacoes": 0,
  "aceita_reservas": true,
  "amenidades": ["Wi-Fi", "Esplanada"],
  "url": "https://app.mozinone.co.mz/listing/restaurante-exemplo/"
}

Empresa fictícia, de propósito. Repare no "rating": null — é assim que virá enquanto a empresa não tiver avaliações reais. Não inventamos pontuações.

Quem poderia usar

Se é a sua situação, é de si que queremos ouvir.

Agências de viagens

Mostrar hotéis e restaurantes moçambicanos no seu site de viagens.

Apps móveis

Integrar o diretório do MOZinONE App na sua aplicação Android ou iOS.

Portais corporativos

Permitir que os funcionários encontrem serviços locais no portal da empresa.

Análise de mercado

Usar dados de empresas para estudos de mercado e relatórios sectoriais.

Precisa mesmo desta API?

Diga-nos o que faria com ela.

Não prometemos data — prometemos que lemos todos os pedidos e que o avisamos se avançar. Quanto mais concreto for, mais peso tem.