Documentação de recursos

O conteúdo do portal Gazeta Esportiva atualmente é fornecido nos formatos JSON, XML e RSS para seus parceiros.

URL Base

http://apigpressparceiros.gazetaesportiva.com

Autenticação

O método de autenticação pode ser feito de duas maneiras:

No caso do HTTP Basic ao qual, antes de consumir o conteúdo, será necessário você efetuar a autenticação de acordo com suas credenciais no cabeçalho da requisição.

Poderá também ser feito por um token a ser informado como um parâmetro na URL. Isso pode ser útil caso possua um CMS que só aceite uma URL de entrada, sem a possíbilidade de autenticação por HTTP Basic.

Suas credenciais serão fornecidas uma vez firmada a parceria com suas devidas questões contratuais.

Formato JSON

Por padrão, o retorno de uma requisição será feito em formato JSON, mas também tem a disposição outros formatos conforme será demonstrado mais adiante.

http://apigpressparceiros.gazetaesportiva.com/noticias

Formato XML

O formato XML é um formato com fins de retrocompatibilidade para os nossos clientes. Caso tenha interessebasta acessar a URL abaixo:

http://apigpressparceiros.gazetaesportiva.com/noticias.xml

Formato RSS 2.0

Para obter o conteúdo no formato XML compatível com RSS 2.0 basta acessar a URL abaixo:

http://apigpressparceiros.gazetaesportiva.com/rss.xml

Limitando os resultados

Por padrão, o entregamos as notícias das últimas 48 horas em nosso feed.

Caso deseje restringir o número de notícias, basta informar na query string o parâmetro limit, conforme exemplo:

https://apigpressparceiros.gazetaesportiva.com/noticias?limit=10

O exemplo anterior irá retornar somente as últimas 10 notícias dentre todas as disponíveis dentro do período supracitado.

RSS por categorias

As notícias também podem ser agrupadas pela sua categoria. Para saber as categorias disponíveis basta acessar a URL abaixo que irá retornar os endpoints disponíveis para que possa acessá-las.

https://apigpressparceiros.gazetaesportiva.com/categorias

Exemplos de uso

Obter todas as notícias em formato JSON autenticando por HTTP Basic:

curl -X GET -u 'seu_usuario:sua_senha' https://apigpressparceiros.gazetaesportiva.com/noticias

Obter as 10 notícias mais recentes em formato RSS utilizando um Token.

https://apigpressparceiros.gazetaesportiva.com/rss.xml?limit=10&token=XXXXXXXXXXXXXXXXX

Obter todas as notícias da categoria Futebol utilizando um token.

https://apigpressparceiros.gazetaesportiva.com/categorias/futebol/rss.xml?token=XXXXXXXXXXXXXXXXX"
Observação: Para saber as categorias disponíveis basta fazer uma requisição para /categorias no qual todas disponíveis serão retornadas em uma lista de endpoints válidos para efetuar a requisição.