Changelog

Ricardo Vitorino edited this page Apr 23, 2014 · 22 revisions

Versão 1.11.0

Data da release: 23 de Abril de 2014

API

  • [ feature ] O API Explorer da OST agora permite obter dados referentes aos Eventos, Pontos de Interesse e respectivas Categorias em várias línguas, possibilitando o utilizador de escolher em que língua pretende obter os dados:

    accept language

  • [ enhancement ] A API referente aos Eventos devolve o Ponto de Interesse associado ao mesmo, no campo parent_poi.

  • [ enhancement ] A API de Eventos consegue devolver os eventos que ainda estão a decorrer numa determinada data, através do parâmetro ongoing. Por exemplo, para obter os eventos que estão a decorrer no dia 25 de Abril:

    ```
    https://api.ost.pt/events?ongoing=2014-04-25
    ```
    

Versão 1.10.0

Data da release: 20 de Março de 2014

API

  • [ feature ] As API referentes aos Eventos, Pontos de Interesse e respectivas Categorias, oferecem agora a internacionalização (i18n) dos seus dados. Utilizando o HTTP Header Accept-Language, é possível obter os dados em castelhano (passando o valor es ou es_ES) e em inglês (passando o valor en ou en_GB). Tal como documentado aqui, pode-se utilizar as ferramentas Postman ou hurl para testar esta funcionalidade.

  • [ enhancement ] O recurso pois agora devolve também as Tags associadas a cada Ponto de Interesse. Estes dados também estão disponíveis com internacionalização.

  • [ enhancement ] No recurso agencies os objectos devolvidos estão agora ordenados por agency_name.

Resource Versioning

  • [ feature ] O recurso routes tem uma nova versão (v2). Nesta versão o parâmetro de query agency é obrigatório.

  • [ feature ] O recurso trips tem uma nova versão (v2). Nesta versão o parâmetro de query route é obrigatório.

  • [ feature ] O recurso stops tem uma nova versão (v2). Nesta versão é obrigatório o uso de um dos seguintes parâmetros de query: agency, route ou trip.

  • [ feature ] O recurso pois tem uma nova versão (v2). Nesta versão, o JSON devolvido não contemplam as chaves start_time e end_time.

Para obter as novas versões dos recursos (e.g. das routes), basta usar o parâmetro version no URL, como se pode ver no API Explorer.

De salientar também que as novas versões dos recursos acima apresentadas, serão futuramente as versões default dos respectivos recursos. A equipa da OST aconselha os developers a migrarem as suas aplicações de acordo com essas alterações.

API Explorer

  • [ feature ] Já é possível utilizar as API com autenticação por OAuth (users e activitystream). Saiba mais sobre como usar o protocolo OAuth aqui.

Versão 1.9.0

Data da release: 06 de Março de 2014

API: Events

  • [ feature ] Nova API que retorna os eventos existentes na base de dados da OST. Tem um funcionamento em tudo semelhante à dos Pontos de Interesse, mas permite também a procura por eventos que ocorrem depois de uma determinada data (campo start_date).

Support Forum

  • [ enhancement ] Já não é possível submeter feedback anonimamente, para evitar que o autor não receba notificações das respostas.

Versão 1.8.1

Data da release: 27 de Janeiro de 2014

API: Category has parent?

  • [ feature ] A API de categorias de Pontos de Interesse agora possui um atributto (boolean) de nome has_parent que permite filtrar as categorias pelo facto de terem uma categoria-pai ou não.

Versão 1.8.0

Data da release: 17 de Janeiro de 2014

E-mail confirmation

  • [ enhancement ] Quando um utilizador se regista na plataforma, é-lhe enviado um e-mail com um link para activar a sua conta, só podendo autenticar-se em www.ost.pt depois de proceder a essa activação.

OAuth 1.0

  • [ feature ] Foi descontinuado o protocolo de autorização OAuth 1.0, tal como havia sido publicado, e foram removidos alguns legacy URL (descontinuados).

Internacionalização

  • [ enhancement ] Foram melhoradas algumas traduções para português.

Versão 1.7.0

Data da release: 22 de Outubro de 2013

Search Apps

  • [ feature ] É possível agora pesquisar pelas aplicações existentes no catálogo de aplicações.

    search

Unpublish Apps

  • [ feature ] Depois de publicada uma aplicação, só era possível removê-la do catálogo de aplicações, agora já é possível fazer unpublish dessa app.

Design do Portal

  • [ feature ] As aplicações podem ser associadas a uma iniciativa, por exemplo um determinado concurso de aplicações, o que permite catalogar com mais detalhe as apps presentes no portal e as que serão submetidas no futuro.

  • [ enhancement ] Foram actualizados os styleguides para a mais recente versão do Bootstrap.

Campo last_modified do resource POI

  • [ enhancement ] O campo last_modified do resource POI reflecte agora eventuais actualizações à categoria à qual pertence ou às tags que lhe estejam associadas.

Versão 1.6.0

Data da release: 13 de Março de 2013

Postos de Carregamento MOBI.E

  • [ feature ] A plataforma One.Stop.Transport já disponibiliza dados sobre os Postos de Carregamento MOBI.E, para veículos eléctricos, na categoria 422 de Pontos de Interesse:

     https://api.ost.pt/pois?category=422
    

Modelo POI com atributo metadata

  • [ enhancement ] Os Pontos de Interesse agora têm um atributo de metadados, já utilizado pelos Postos de Carregamento para informação como o número de tomadas. Este atributo poderá no futuro vir a ser utilizado para dados de acessibilidade, por exemplo.

Exemplo:

Objects: [
    {       
        resource_uri: "/pois/83880",
        id: 83880,
        categories: [
        {
            id: 422,
            name: "Postos MOBI.E",
            resource_uri: "/pois/categories/422"
        }
        ],
        metadata: {
            tipo_tomadas: "Normal",
            num_tomadas: 2
        },
        (…)
    },
    (…)
]

APIs

  • [ feature ] Nova API que devolve, dado um conjunto de coordenadas, quais as divisões administrativas a que o ponto pertence: freguesia, munícipio e distrito.

Exemplo: https://api.ost.pt/whereat?coords=-8.40,40.2

{
    parish: {
        name: "Santo António dos Olivais",
        resource_uri: "/parishes/5760"
    },
    municipality: {
        name: "Coimbra",
        resource_uri: "/municipalities/379"
    },
    district: {
        name: "Coimbra",
        resource_uri: "/districts/35"
    }
}
  • [ enhancement ] As APIs de distritos, munícipios e freguesias quando chamadas com os parâmetros center e range, devolvem as regiões ordenadas crescentemente por distância.

Versão 1.5.0

Data da release: 21 de Fevereiro de 2013

Social Sign-in

  • [ feature ] É agora possível registar e fazer sign-in no One.Stop.Transport a partir do Facebook e Twitter.

Hypermedia API

As API's da One.Stop.Transport são agora hypermedia, de modo a facilitar o trabalho a webcrawlers.

  • [ enhancement ] Cada resource devolvido em lista contem agora na sua representação JSON o atributo resource_uri. Este indica URI correcto para aceder ao resource em causa.

  • [ enhancement ] Os metadados que acompanham a resposta contêm agora o URI correspondente à página seguinte e anterior (nex_page e previous_page respectivamente) dos resources em causa.

Exemplo:

{
	Objects: [{
		… 
		resource_uri: "/stops/xxxx"
		},
		… 
	],
	Meta: {
		validated_parameters: {
			results: 25,
			offset: 0
		},
		next_page: "/stops/?key=key&offset=50",
		previous_page: "/stops/?key=key&offset=0",
		… 
	}
}

Dev Challenge

  • [ enhancement ] O site do concurso Dev Challenge tem agora um novo e melhorado design.

  • [ bugfix ] Corrigido bug na submissão de aplicações a concurso a partir de browsers IE.

  • O prazo de submissão de aplicações a concurso foi extendido de modo a abranger o segundo semestre do ano escolar 2012-2013. A data limite ainda está em discussão.

OAuth

  • [ bugfix ] Foi corrigido um bug na implementação OAuth1.0 para suportar o fluxo para aplicações móveis nativas.

Versão 1.4.1

Data da release: 22 de Janeiro de 2013

API NextRoutes

  • A API que devolve as próximas trips, que passam por uma determinada paragem, agrupadas por route, mudou o endereço de https://api.ost.pt/stops/{stop_id}/routes/next para https://api.ost.pt/routes/next, sendo que o recurso stop_id é agora passado como parâmetro no endereço (?stop_id=…)

Explorador da API

  • Os recursos NextRoutes e Headsigns foram agregados no recurso Routes, estando agora as suas APIs nesse recurso

  • A nova versão do Explorador das APIs agora indica, para cada uma das APIs, os códigos de erro que estas podem devolver

  • Esta nova versão mostra também modelos (em pseudo-código ou em esquema JSON) para as respostas devolvidas por cada API


Versão 1.4.0

Data da release: 18 de Dezembro de 2012

OAuth.1

  • Authorize passou de https://ost.pt/appbase/auth/ para https://auth.ost.pt/v1/authorize/

  • Request token passou de http://auth.mobility.tice.ipn.pt/oauth/request_token/ para https://auth.ost.pt/v1/request_token/

  • Access token passou de http://auth.mobility.tice.ipn.pt/oauth/access_token/ para https://auth.ost.pt/v1/access_token/

OAuth.2

  • Authorize passou de https://ost.pt/appbase/auth/ para https://auth.ost.pt/v2/authorize/

  • Token passou de http://auth.mobility.tice.ipn.pt/oauth2/v16/token/ para https://auth.ost.pt/v2/token/

API de dados

Todas as APIs disponibilizadas encontram-se agora no sub-domínio api.ost.pt perdendo a path /rest/ do seu URI. Por exemplo:

https://ost.pt/rest/agencies passou para https://api.ost.pt/agencies

Outros

  • Explorador da API passou de https://www.ost.pt/developers/api-explorer para https://developer.ost.pt/api-explorer

  • Documentação passou de https://www.ost.pt/developers/docs para https://developer.ost.pt/docs

  • Concurso de aplicações passou de https://www.ost.pt/challenge para https://challenge.ost.pt

  • Fórum de suporte passou de https://www.ost.pt/support para https://support.ost.pt


Versão 1.3.1

Data da release: 5 de Novembro de 2012

  • [ enhancement ] Revisão das respostas de erro na submissão de packaged apps e hosted apps
  • [ bugfix ] Corrigido um bug no funcionamento do OAuth 2.0 desktop flow
  • [ bugfix ] Web layers já funcionam com HTTPS
  • [ enhancement ] Melhorias ao nível do sandboxing de packaged apps

Versão 1.3.0

Data da release: 2 de Novembro de 2012


Versão 1.2.0

Data da release: 26 de Outubro de 2012

  • [ feature ] Suporte a aplicações móveis
  • [ feature ] Login via e-mail
  • [ feature ] Recuperação da password
  • [ feature ] HTTPS obrigatório em todo o site. As aplicações de demonstração (packaged) foram igualmente migradas.
  • [ enhancement ] Na API de trips foi removido o parâmetro with_stops
  • [ enhancement ] Na API de trips os parâmetros date e time encontram-se agora separados
  • [ bugfix ] Corrigido um bug na API next_routes
  • [ enhancement ] Nas APIs de trips e stoptimes os campos arrival_time e departure_time passaram para a sua forma plural: arrival_times e departure_times, respectivamente
  • [ bugfix ] Corrigido bug no contentor de aplicações Hosted e Packaged que impedia a utilização de algumas APIs JavaScript (nomeadamente a de internacionalização)

Versão 1.1.1

Data de release: 10 de Outubro de 2012

  • [ Bugfix ] É agora possível obter a fronteira geográfica dos distritos e ilhas de Portugal usando a API de districts;
  • [ Enhancement ] O JSON devolvido nas APIs agora é single-line e sem whitespaces, o que permite que as respostas sejam mais leves;
  • [ Enhancement ] Na API de horários (stoptimes), os campos arrival_time e departure_time podem agora ser de três tipos: null, hora ou lista de horas. Segue um exemplo de uma lista de horas devolvida:
	"departure_time": [
        "07:15:00",
        "07:35:00",
        "09:05:00",
        "09:35:00",
        "10:05:00",
        "10:35:00",
        "11:05:00",
        "11:35:00",
        "12:05:00",
        ...
      ],
  • [ Enhancement ] A API de stops sofreu alterações ao nível da resposta, apresentando o campo parent_station de forma diferente. Antes devolveria:
	"parent_station": {
		"id": 1234
	}

E agora devolve:

	"parent_station_id": 1234
  • [ Enhancement ] A API de trips sofreu alterações ao nível da resposta no que toca aos campos shape e route. Antes devolveria:
	"shape": {
		"id": 1234
	},
	"route": {
		"id": 1235
	}

E agora devolve:

	"shape_id": 1234,
	"route_id": 1235

Versão 1.1.0

Data de release: 4 de Outubro de 2012

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.