N-Ways
Documentação para programadoresRegisto de alterações

Está a desenvolver com o N-Ways?

Obter uma chave de API

Registo de alterações e versões

O que mudou, e como mudamos as coisas sem estragar a sua aplicação.

Nesta página

Registo de alterações

27 de outubro de 2026: disponibilidade geral

  • Todas as API e todos os SDK estão em disponibilidade geral; acabaram as indicações de pré-visualização. Todas as API têm a mesma promessa: alterações incompatíveis só numa nova versão, anunciadas com pelo menos 12 meses de antecedência. Como funcionam as versões
  • Termos 1.3: saem os termos próprios da pré-visualização; os compromissos de disponibilidade vêm com os planos Business e Enterprise. Termos
  • Preços: os preços publicados são os preços em vigor.

27 de outubro de 2026: português

  • A documentação para programadores em português, com a referência da API, em /pt/developers.
  • SDK Maps 1.1: lang: 'pt' mostra os nomes em português quando existem. SDK Maps

27 de outubro de 2026: parar um plano mensal

  • Parar o plano em Faturação, na consola: o plano decorre até ao fim do mês pago, sem novas faturas, e depois as novas entregas ficam em pausa até escolher um plano; o crédito mantém-se. Manter o meu plano anula a paragem. Passar a só API também espera agora pelo fim do mês pago. Preços
  • Termos 1.2: a renovação e a paragem do plano mensal, nos termos.

23 de outubro de 2026: gerir as entregas no N-Ways

  • Nova recusa API_ACCESS_OFF (403): uma organização que gere as entregas no N-Ways sem a API tem as chaves desativadas. Adicione a API na consola, em Faturação, para as usar; as chamadas à API passam então a ser pagas por uso. Erros
  • Planos mensais para as empresas que gerem as entregas na consola e no N-Ways Business. Preços

16 de outubro de 2026: uma chave num minuto

  • Frota: para onde vai cada veículo. GET /fleet/routes dá, para cada veículo numa entrega, o caminho percorrido, o caminho pela frente por cada paragem prevista (calculado pelo motor de percursos) e as suas paragens numeradas por ordem. Cada veículo tem uma colour (16 chaves; definida na criação ou com PATCH /vehicles/{id}) usada em todos os mapas, e cada entrega uma ref curta (#1042) para as pessoas; os alertas trazem taskRef e taskLabel. Referência da API
  • Sem etapa de aprovação. Registe-se com Google, Apple ou e-mail, dê o nome da sua empresa, e a sua chave fica pronta de imediato, com os passos para a integrar na web, em Android, em iOS ou por REST. Utilização gratuita todos os meses.
  • Cada recusa diz exatamente porquê e como resolver, com uma ligação para a sua entrada na página Erros em error.details (o ErrorInfo e o Help da Google) e cabeçalhos CORS para que o código do navegador a possa ler. Novos motivos: PLATFORM_DISABLED (503: a plataforma está desligada, a sua chave é válida), PLATFORM_PREVIEW_ONLY, API_KEY_REVOKED (chaves eliminadas ou regeneradas, que antes respondiam API_KEY_INVALID), ORGANISATION_SUSPENDED (antes PARTNER_SUSPENDED), ORGANISATION_CLOSED e API_KEY_PAUSED (antes API_KEY_DISABLED). As recusas por restrição mostram o que foi visto e o que é permitido; os limites dizem qual e quando são repostos. O SDK Maps para a web 1.0.1 mostra a mensagem sobre o mapa.
  • Acima das chamadas gratuitas, paga o crédito em qualquer plano, incluindo o Starter. Sem crédito, as chamadas acima das gratuitas recebem 402 BILLING_DISABLED (era 403) com uma mensagem a pedir para adicionar crédito. Erros

15 de outubro de 2026: versão 1 das API, dos SDK e da frota

15 de outubro de 2026: chaves de API

  • As chaves são verificadas: restrições de site, Android, iOS e IP, restrições de API (Mapas, Geocodificação, Lugares, Percursos, Tarifas, Trânsito, Fotos), limites de débito por minuto e limites diários. Os motivos de erro são definitivos: veja Erros.
  • X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset em cada resposta autorizada; Retry-After em cada 429.
  • O consumo acima das chamadas gratuitas mensais de cada API é faturado a partir do crédito pré-pago ou por fatura, conforme o contrato (BILLING_DISABLED quando o crédito pré-pago se esgota).
  • Definições ao nível do projeto: as API do seu plano aplicam-se a cada chave, os limites podem abranger todas as chaves de um projeto em conjunto, e um projeto suspenso recebe 403 PARTNER_SUSPENDED. Veja Erros.
  • SDK Maps 0.1.1: um mosaico recusado escreve agora também o seu código HTTP na consola.

15 de outubro de 2026: a documentação para programadores

  • A documentação para programadores.
  • SDK Maps para a web 0.1 em https://nways.ng/sdk/v0/nways-maps.js: createMap, temas claro e escuro, etiquetas em francês, buildStyle para o seu próprio estilo.
  • API documentadas: Mosaicos, Geocodificação (com os códigos postais NIPOST e o GhanaPost GPS), Lugares, Percursos, Tarifas e Trânsito.
  • Chaves de API: envie key= ou X-NWays-Api-Key em cada pedido.

Como funcionam as versões

  • As API de serviços web trazem a versão principal no caminho: /maps/v1/. Dentro de uma versão, só acrescentamos: novos pontos de acesso, novos parâmetros opcionais, novos campos nas respostas. Escreva o seu código para ignorar os campos que não conhece.
  • Uma alteração incompatível (remover ou mudar o nome de um campo, mudar o significado de um parâmetro) chega numa nova versão, /maps/v2/. A antiga continua a funcionar pelo menos 12 meses depois de a nova estar estável.
  • Os SDK Maps seguem o versionamento semântico. /sdk/v1/ serve sempre a última 1.x; /sdk/v1.0.0/ e as versões exatas seguintes nunca mudam. /sdk/v0/ continua a servir a antiga 0.1.
  • Os dados do mapa (estradas, lugares, códigos postais) mudam todos os dias, à medida que as pessoas corrigem o mapa. Isso não é uma mudança de versão.

Descontinuações

Nenhuma por agora. Quando algo é descontinuado, fica indicado aqui com o que o substitui e a data em que deixa de funcionar, e os parceiros que o usam recebem um e-mail.

Estado do serviço e assistência

Assistência em inglês ou francês, e o estado do serviço.