Developer faq

Ricardo Vitorino edited this page Jan 29, 2014 · 9 revisions

Por onde começo?

O primeiro passo consiste em registar conta na plataforma em www.ost.pt. Como ainda não existe a possibilidade de escolher o tipo de conta (individual / empresa), recomendamos usar uma conta 'developer' normal e usar essas credenciais para os testes de integração. Para associar a sua nova conta a uma conta de developer, basta aceder às Configurações, no fundo da sidebar e aceder à terceira tab, também intitulada de Configurações.

Onde está a especificação das API?

As API REST existentes à data estão disponíveis num playground onde é possível testá-las directamente através do browser, bastante útil para testes de integração. Aqui, a especificação está implícita nos campos que é possível preencher para cada par verbo/URL. A utilização deste playground implica a utilização de uma chave do tipo browser, sendo possível obter uma no portal da plataforma caso tenha um perfil de developer.

Preciso de uma API que não está lá. E agora?

A plataforma One.Stop.Transport vive de dados, tendo as suas APIs sido criadas de acordo com os dados existentes e com as necessidades dos parceiros do projecto. No caso de achar relevante a inclusão de uma API específica, pode usar o fórum de suporte para nos deixar a sugestão.

Encontrei um bug numa das API. Como prosseguir?

Basta inserir um tópico no fórum de suporte e esperar que seja respondido.

A minha hosted app não aparece bem em alguns browsers. O que fazer?

A OST funciona sob o protocolo SSL, ou seja, todas as páginas são servidas via HTTPS. Se uma hosted app, disponível apenas por HTTP, for carregada num iframe, o conteúdo da mesma pode não ser imediatamente apresentado pelos browsers, visto ser considerado inseguro. Como tal, para evitar que os utilizadores tenham de alterar as preferências de segurança dos seus browsers, recomendamos vivamente que disponibilizem as hosted apps com SSL.

Quais são as guidelines para os ícones das aplicações?

Para uma apresentação optimizada no marketplace da OST, recomenda-se fortemente que as aplicações apresentem um ícone quadrado, com dimensões iguais ou superiores a 270x270 pixels, garantindo assim que são apresentadas com boa definição tanto em desktop como em mobile. Disponibilizamos um ficheiro .psd como template aqui.

O que são as iniciativas associadas às aplicações?

É previsível que haja concursos de aplicações específicos de eventos e/ou regiões. Quando o developer submete uma aplicação no portal, independente de ser Packaged, Hosted ou Mobile, é-lhe pedida uma iniciativa para associar à aplicação. No caso da aplicação ter sido desenvolvida com esse fim (concurso de aplicações), esse atributo deve ser preenchido de acordo com as iniciativas actualmente em vigor.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.