Fevereiro 2009 - SAPO developers blog

Segunda-feira, 23 de Fevereiro de 2009

O SAPO disponibiliza um Web Service para consulta de feriados portugueses (nacionais, regionais e municipais).

Para consultar os feriados nacionais de 2009, por exemplo, basta invocar o serviço em http://services.sapo.pt/Holiday/GetNationalHolidays?year=2009.

A resposta do serviço é semelhante a (mas mais extensa):

    <GetNationalHolidaysResponse xmlns="http://services.sapo.pt/Metadata/Holiday">
        <GetNationalHolidaysResult>
            <Holiday>
                <Name>Ano Novo</Name>
                <Date>2009-01-01T00:00:00</Date>
                <Description>O Ano-Novo é um evento que acontece quando uma cultura celebra o fim dd
e um ano e o começo do próximo. Todas culturas que têm calendários anuais celebram o ""
Ano-Novo". A celebração do evento é também chamada réveillon, termo oriundo do verbo  
réveiller, que em francês significa "despertar".</Description>
                <Type>National</Type>
            </Holiday>
            <Holiday>
                <Name>Carnaval</Name>
                <Date>2009-02-24T00:00:00</Date>
                <Description>Feriado facultativo, sendo rara a sua não utilização na prática. A  
data tem origem na tradição pagã de celebrar o final do inverno e foi depois adaptada pp
ela Igreja Católica marcando agora o período de 40 dias antes da Semana Santa (Quaresma))
, ou 47 dias antes da Páscoa, sendo conhecido também por Entrudo</Description>
                <Type>Optional</Type>
            </Holiday>
            ...
        </GetNationalHolidaysResult>
    </GetNationalHolidaysResponse>

Mais exemplos de utilização deste método podem ser consultados em http://services.sapo.pt/Metadata/Service/Holiday/GetNationalHolidays.

Portugal possui 14 feriados:

10 feriados fixos: Ano Novo, Dia da Liberdade, Dia do Trabalhador, Dia de Portugal, Assunção de Nossa Senhora, Implantação da República, Dia de Todos-os-Santos, Restauração da Independência, Imaculada Conceição e Natal;

4 feriados móveis: Páscoa, Sexta-feira Santa (antes da Páscoa), Carnaval (47 dias antes da Páscoa) e Corpo de Deus (60 dias após a Páscoa).

Para estes últimos feriados móveis existem também métodos específicos (caso não desejemos uma lista exaustiva de feriados): GetEaster, GetCorpusChristi, GetGoodFriday e GetCarnival.

O serviço suporta o cálculo dos feriados para os anos entre 1582 e 2299.

A descrição do serviço e dos seus métodos encontra-se disponível em http://services.sapo.pt/Metadata/Service/Holiday.

tags: feriados, integração, web services

publicado por jac às 10:00
link do post | comentar | ver comentários (5) | adicionar aos favoritos |

Segunda-feira, 16 de Fevereiro de 2009

SAPO Captcha

Um CAPTCHA é um "Completely Automated Public Turing test to tell Computers and Humans Apart."

Um tipo usual consiste em pedir ao utilizador que identifique os caracteres de uma imagem distorcida.

O SAPO disponibiliza esta funcionalidade através de um Web Service disponível em http://services.sapo.pt/Captcha/.

Gerar um novo CAPTCHA é tão simples como fazer um pedido a http://services.sapo.pt/Captcha/Get.

O serviço retorna uma resposta como:

    <Captcha>
        <id>b853bd89516e650be2bba45fed191319f8387ed2</id>
        <code>sader441</code>
        <msg>ok</msg>
    </Captcha>

Onde id é o identificador do CAPTCHA gerado e code é a mensagem distorcida.

A partir daqui pode-se exibir a imagem recorrendo apenas a HTML:

<img src="http://services.sapo.pt/Captcha/Show?id=
          b853bd89516e650be2bba45fed191319f8387ed2" />

Resta apenas comparar a resposta do utilizador com o parâmetro recebido em code e podemos assim distinguir um bot de um utilizador.

O serviço possui ainda mais uma série de parâmetros que permitem costumizar o aspecto da imagem e o tempo de vida e tamanho do CAPTCHA.

Por exemplo, gerar um CAPTCHA de 9 caracteres numéricos:

http://services.sapo.pt/Captcha/Get?mode=numeric&length=9

Mostrar o CAPTCHA com o texto a vermelho sob fundo azul e fonte tamanho 14:

http://services.sapo.pt/Captcha/Show
       ?id=401b4f9820a2ce4c0177f2010ded67bf04757a23
       &textcolor=ff0000&size=14&background=0000ff

E aqui está uma forma simples de implementar CAPTCHAs nas suas soluções sem que tenha que desenvolver esta funcionalidade.

A descrição do serviço encontra-se em http://services.sapo.pt/Metadata/Service/Captcha.

tags: captcha, integração, web services

publicado por jac às 10:00
link do post | comentar | ver comentários (2) | adicionar aos favoritos |

Quinta-feira, 12 de Fevereiro de 2009

Re-arranque

Tem hoje início (pela segunda vez) este blog, direccionado a todos os developers que tenham interesse em usar ou integrar alguma plataforma ou serviço do SAPO.

Stay tuned.

publicado por jac às 17:25
link do post | comentar | ver comentários (1) | adicionar aos favoritos |

Autores

celso

jac

rcarmo

pesquisar

Janeiro 2012

Dom

Seg

Ter

Qua