EM ESTUDO

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.

Porque estamos a perguntar em vez de anunciar. 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, entra no plano com data. Se não houver, dizemos que não e ficamos os dois a ganhar.

O que faria sentido na primeira versão

Uma proposta, não uma promessa. Diga-nos o que falta ou o que sobra.

Pesquisar empresas

Pesquisa por nome, categoria, localização ou província, com 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 empresas, essas 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.

Header: X-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"],
  "fotos": [
    "https://app.mozinone.co.mz/.../foto1.jpg"
  ],
  "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 está numa destas situações, é 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 directó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.