MOBI.Docs
Versão da especificação: v1.0

Estrutura de endpoints

Como o MOBI.Hub descobre os endpoints dos participantes e constrói os URL finais de cada módulo.

Nesta página

O MOBI.Hub expõe as suas interfaces OCPI através de endpoints dedicados. Os endpoints de referência da plataforma MOBI.Hub são:

  • Qualidade: https://hub-qld.mobie.pt/ocpi/hub/versions
  • Produção: https://hub.mobie.pt/ocpi/hub/versions

O MOBI.Hub não impõe quaisquer restrições quanto ao nome de anfitrião (hostname), ao nome de domínio ou ao caminho base usados por CPO e EMSP para expor os seus serviços OCPI.

Em particular, os endpoints expostos para os módulos Versions, Version Details e Credentials podem seguir qualquer estrutura escolhida pelo participante.

Descoberta dinâmica

A descoberta de todos os endpoints OCPI é feita dinamicamente através dos procedimentos normalizados de Versions e Credentials.

Depois de obtido o endpoint Version Details, o MOBI.Hub usa os URL anunciados para cada módulo e papel para construir o endpoint final de acordo com as regras definidas pela especificação OCPI.

Por exemplo, se um participante expuser o seguinte endpoint recetor (receiver) de Sessions:

  • https://api.example.com/custom/path/sessions

o MOBI.Hub constrói o URL para atualizar uma sessão de acordo com a especificação OCPI:

{sessions_endpoint_url}/{country_code}/{party_id}/{session_id}
  • Exemplo: https://api.example.com/custom/path/sessions/PT/ABC/123456

O mesmo princípio aplica-se a todos os módulos OCPI que definem parâmetros de caminho adicionais.