Copiado com sucesso.
Encurtando

Faça links e use em blogs, fóruns, redes sociais, mensagens instantâneas, publicações on-line ou campanhas publicitárias.

 

 

A API do Peqn.in foi desenvolvida para que os desenvolvedores possam aproveitar melhor os serviços de nosso site. Com estas, eles podem integrar suas aplicações e sites, criando novas funcionalidades.

Abaixo apresentamos os formatos disponíveis para integração. Se houver alguma dúvida, mande-a diretamente para nosso email de suporte (contato@peqn.in) ou acesse nossa área de contato, que tentaremos ajudar.


Retornos de Status

Para toda solicitação, é retornado um status da operação, abaixo apresentamos os possíveis status.
  • status_numero: 200 - status_descricao: OK
  • status_numero: 201 - status_descricao: URL_INVALIDA
  • status_numero: 202 - status_descricao: DADOS_INVALIDO
  • status_numero: 203 - status_descricao: ERRO_DESCONHECIDO

Gerar Links Restritos

É possivel criar links restritos a você para ter acessos a estatísticas de visitas. Para isso basta adicionar na url de requisição o seguinte codigo: &i=4c6586446097f(identificação).

Para obter esta identificação basta fazer o cadastro no site. Uma vez cadastrado você poderá ver todos os links que você criou e poderá também excluir estes se desejado.

Toda url que deseja encurtar tem que passar pelo URL-encoded, onde este irá substituir caracteres com '&', '?', '#', " entre outros caracteres especiais.


Parâmetros de envio

url=http%3A%2F%2Fwww.google.com.br
formato=json
i=4c6586446097f

url - url que deseja enviar para encurtar lembrando de passar pelo URL-encode (Obrigatório);
formato - json, xml e txt (Opcional - Default txt);
i - identificador (opcional) usado para ter um controle sobre seus links gerados. Para obter basta fazer o cadastro no site.


Formatos Disponíveis

Formato JSON

Formato para envio de url:

http://api.peqn.in/?url=http%3A%2F%2Fwww.google.com.br&formato=json&i=4c6586446097f

Retorno JSON:

{
    "status_numero": 200, 
    "status_descricao": "OK", 
    "dados": {
        "url": "http://peqn.in/1abae", 
        "chave": "1abae", 
        "url_original": "http://www.google.com.br/", 
        "click": 0,
        "data": "2010-08-09 10:30:58"
    };
}

Formato XML

Formato para envio de url:

http://api.peqn.in/?url=http%3A%2F%2Fwww.google.com.br&formato=xml&i=4c6586446097f

Retorno XML:

<?xml version="1.0" encoding="UTF-8"?>
<resultado>
    <status_numero>200</status_numero>
    <status_descricao>OK</status_descricao>
    <dados>
        <url>http://peqn.in/1abae</url>
        <chave>1abae</chave>
        <url_original>http://www.google.com.br/</url_original>
        <click>0</click>
        <data>2010-08-09 10:30:58</data>
    </data>
</resultado>

Formato TXT

Formato para envio de url:

http://api.peqn.in/?url=http%3A%2F%2Fwww.google.com.br&formato=txt&i=4c6586446097f

Retorno TXT:

http://peqn.in/1abae

Compartilhar no Twitter

Formato para envio de url:

http://api.peqn.in/compartilhar?msg=Mensagem de teste www.google.com.br acesse.

Mensagem com url ja transformada dentro do twitter.

Mensagem de teste http://peqn.in/1abae acesse.