Documentação da API

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:

http://jump2.me/api/shorten/longlink/http%3A%2F%2Fwww.exemplo.com/api_key/c5735d19189ad736565f11619f34d864

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:

http://jump2.me/api/shorten/longlink/http%3A%2F%2Fwww.exemplo.com/api_key/c5735d19189ad736565f11619f34d864/keyword/ex/format/json

Resposta:

{“status”: {“code”: 200, “message”: “OK”}, “result”: “http://jump2.me/ex”}

Requisição:

http://jump2.me/api/shorten/longlink/http%3A%2F%2Fwww.exemplo.com/api_key/c5735d19189ad736565f11619f34d864/keyword/ex/format/xml

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.

Jump2.me é a forma mais inteligente para encurtar e compartilhar links.
Obtenha estatísticas confiáveis que medem a repercussão dos links que você compartilhou.

Pessoas que nós amamos

Eventos que nós amamos

Aplicativos que nós amamos