Visão Geral
A API do Jump2.me oferece um mecanismo para interagir com o serviço programaticamente. Esse documento fornece instruções e exemplos para que um desenvolvedor possa criar aplicações complementares.
Versionamento
Esse documento descreve a versão 1.0 da API. A versão 1.0 é a mais atualizada.
URL de acesso
A URL de acesso a API é http://jump2.me/api/{ação}.
Métodos HTTP
Todas as ações da API atendem a requisições GET.
Exemplo:
http://jump2.me/api/shorten
Código de Resposta HTTP
Todas as respostas trarão o código 200 OK, a não ser que tenha ocorrido alguma anormalidade. Os erros e mensagens gerados pela API devem ser acessados através da mensagem de resposta, codificadas em texto plano, JSON, XML ou qualquer outro formato suportado.
Métodos
/shorten
Encurta a URL informada e retona o novo link.
Parâmetros necessários
api_key=
Um código único que é usado para associar um link a uma conta de usuário. Se esse código não estiver associado a uma conta de usuário válida, a resposta irá conter um erro e a requisição não será processada. Usuários do Jump2.me podem encontrar o código vinculado a suas contas na página de perfil no item “Chave da API”.
longlink=
A URL que deve ser encurtada.
Exemplo:
Parâmetros Opcionais
share=
Se o valor for 1, a URL curta será publicada no Twitter. O valor padrão é 0 (zero).
tweet=
Mensagem de texto que será publicada no Twitter. Pode-se se utilizar $U para marcar a posição do link curto no conteúdo da mensagem.
keyword=
O texto que será usado na geração do link curto. Se não for informado, o link curto será gerado com base em um valor sequencial.
format=
O formato da resposta.
- txt (texto plano – padrão)
- json
- xml
Requisição:
Resposta:
{“status”: {“code”: 200, “message”: “OK”}, “result”: “http://jump2.me/ex”}
Requisição:
Resposta:
<?xml version=”1.0″ encoding=”UTF-8″?>
<xml>
<status>
<code>200</code>
<message>OK</message>
</status>
<result>http://jump2.me/ex</result>
</xml>
Códigos & Mensagens:
- 200 => OK
- 300 => A chave da API não é válida.
- 400 => A URL tem que ser informada.
- 401 => A URL não é válida, pois aponta para um link do Jump2.me.
- 403 => A URL deve ter 2000 caracteres ou menos.




















Pingback: Tutorial: uma forma alternativa de compartilhar notícias no Google Reader |
Pingback: Jump2.me Para WordPress Plugin | Wordpress Plugins