API Protocole

L'API est la même pour safe.mn, clic.gs, go2.gs, cliks.fr et 888.hn.

L'API évolue avec l'ajout de nouvelles fonctionnalités sur le site.

Pour obtenir la liste des librairies (PHP, Perl, Python, Javascript, ...), allez à Librairies.

Raccourcir un lien

Allonger le lien

Détails un lien court

Raccourcir un lien

Requête

Pour raccourcir une adresse, effectuez une requête GET comme ce-ci::

http://safe.mn/api/shorten?url=<url>&format=<format>&callback=<callback>

Avec les valeurs suivantes <...>:

ParamètreRequisSignificationValeur possibleDéfautCommentaire
urlrequisLien longhttp://www.reviews-web-hosting.com/none 
aliasoptionnelalias courtEXAMPLEnoneL'alias doit contenir 5 à 100 caractères (lettres, nombres, _ et -).
formatoptionnelFormat de la réponsexml (XML), json (Json), jsonp (JsonP) ou text (textetext 
callbackoptionnelfonction de rappel pour JsonPsafemn_resultmissing_callbackUtilisé seulement avec format=jsonp

Nous recommandons de ne pas s'appuyer sur les valeurs par défaut. Vous devriez indiquer explicitement le format et le callback (pour JsonP).

Réponse

XML:

Réussie:

<?xml version="1.0" encoding="UTF-8" ?>
<data>
 <url>http://safe.mn/c</url>
</data>

Erreur:

<?xml version="1.0" encoding="UTF-8" ?>
<data>
 <error>Invalid URL</error>
</data>

Json:

Réussie:

{ "url": "http://safe.mn/c" }

Erreur:

{ "error": "Invalid URL" }

JsonP (callback=safe123):

Réussie:

safe123({ "url": "http://safe.mn/c" })

Erreur:

safe123({ "error": "Invalid URL" })

Texte:

Réussie:

http://safe.mn/c

Erreur:

Error: Invalid URL

Note: la réponse peut contenir des espaces supplémentaires (tabulation, espace, saut de ligne).

Exemples

Requête:

http://safe.mn/api/shorten?url=http://www.aol.net/&format=jsonp&callback=safe123

Réponse:

safe123({ "url": "http://safe.mn/c" })

Requête:

http://safe.mn/api/shorten?url=http://www.aol.net/&alias=AOL-NET&format=json

Réponse:

{ "url": "http://safe.mn/AOL-NET" }

Haut

Allonger le lien

Requête

Pour obtenir l'adresse finale d'un lien court, effectuez une requête GET de cette façon:

http://safe.mn/api/expand?short_url=<url>&format=<format>&callback=<callback>

Avec les valeurs suivantes <...>:

ParamètreRequisSignificationValeur possibleDéfautCommentaire
short_urlrequisLien court http://safe.mn/1none 
formatoptionnelFormat de la réponsexml (XML), json (Json), jsonp (JsonP) ou text (textetext 
callbackoptionnelfonction de rappel pour JsonPsafemn_resultmissing_callbackUtilisé seulement avec format=jsonp

Nous recommandons de ne pas s'appuyer sur les valeurs par défaut. Vous devriez indiquer explicitement le format et le callback (pour JsonP).

Réponse

XML:

Réussie:

<?xml version="1.0" encoding="UTF-8" ?>
<data>
 <url>http://www.google.com/</url>
</data>

Erreur:

<?xml version="1.0" encoding="UTF-8" ?>
<data>
 <error>Invalid URL</error>
</data>

Json:

Réussie:

{ "url": "http://www.google.com/" }

Erreur:

{ "error": "Invalid URL" }

JsonP (callback=safe123):

Réussie:

safe123({ "url": "http://www.google.com/" })

Erreur:

safe123({ "error": "Invalid URL" })

Texte:

Réussie:

http://www.google.com/

Erreur:

Error: Invalid URL

Note: la réponse peut contenir des espaces supplémentaires (tabulation, espace, saut de ligne).

Exemples

Requête:

http://safe.mn/api/expand?short_url=http://safe.mn/c&format=xml

Réponse:

<?xml version='1.0' ?>
<data>
 <url>http://www.aol.net/</url>
</data>

Haut

Détails un lien court

Requête

Pour raccourcir une adresse, effectuez une requête GET comme ce-ci::

http://safe.mn/api/info?url=<url>&format=<format>&callback=<callback>

Avec les valeurs suivantes <...>:

ParamètreRequisSignificationValeur possibleDéfautCommentaire
urlrequisLien longhttp://www.reviews-web-hosting.com/none 
formatoptionnelFormat de la réponsexml (XML), json (Json), jsonp (JsonP) ou text (textetext 
callbackoptionnelfonction de rappel pour JsonPsafemn_resultmissing_callbackUtilisé seulement avec format=jsonp

Nous recommandons de ne pas s'appuyer sur les valeurs par défaut. Vous devriez indiquer explicitement le format et le callback (pour JsonP).

Réponse

json

ParamètreSignificationValeur possibleCommentaire
urlLien longhttp://www.reviews-web-hosting.com/ 
clicksNombre de clics sur le lien court1201Integer
referersNombre de clics par domaine d'origine[["Direct Access/Applications","1,151"],["baidu.com","2"]]Tableau de pairs [Domain, Clicks]
countriesNombre de clics par pays d'origine[["United States","851"],["China","94"]]Tableau de pairs [Country, Clicks]
filetypeType de fichier potentiellement dangereuxapplication/x-dosexecEmpty if safe
virusNom du virusEicar-Test-SignatureVide si aucun virus
dangerousSite dangereuxSpyware/Malware/AdwareVide si sûr
partialTéléchargement incomplet10 si le téléchargement est complet
unreachablePage inaccessible10 si la page est disponible
activexNom de l'ActiveX dangereux00000000-0000-0000-0000-000000000000 CnBabe AdwareVide si sûr
xssCross-Site scripting10 si le lien est sûr
categoryType de contenuAdultVide si sûr
redirectionTrop de redirections10 si le nombre de redirection est bon
errorUne erreur s'est produiteInvalid URLPas de champs erreur si réussi
qr_shortAddresse du code QR pour le lien courthttp://safe.m/static/images/qr/1-safe.gif 
qr_longAddresse du code QR pour l'adresse finalehttp://safe.mn/static/images/qr/1.gif 

jsonp

Same as json.

xml

Nom de la racine: <data>

ParamètreSignificationValeur possibleCommentaire
urlLien long<url>http://www.reviews-web-hosting.com/</url> 
clicksNombre de clics sur le lien court<clicks>1201</clicks>Integer
referersNombre de clics par domaine d'origine<referers>
  <referer clicks="1151" domain="Direct Access/Applications" />
  <referer clicks="2" domain="baidu.com" />
</referers>
List of <referer clicks="Clicks" domain="Domain" />
countriesNombre de clics par pays d'origine<countries>
  <country name="United States" clicks="851" />
  <country name="China" clicks="94" />
<countries>
List of <country name="Country" clicks="Clicks" />
filetypeType de fichier potentiellement dangereux<filetype>application/x-dosexec</filetype>Empty if safe
virusNom du virus<virus>Eicar-Test-Signature</virus>Vide si aucun virus
dangerousSite dangereux<dangerous>Spyware/Malware/Adware</dangerous>Vide si sûr
partialTéléchargement incomplet<partial>1</partial>0 si le téléchargement est complet
unreachablePage inaccessible<unreachable>1</unreachable>0 si la page est disponible
activexNom de l'ActiveX dangereux<activex>00000000-0000-0000-0000-000000000000 CnBabe Adware</activex>Vide si sûr
xssCross-Site scripting<xss>1</xss>0 si le lien est sûr
categoryType de contenu<category>Adult</category>Vide si sûr
redirectionTrop de redirections<redirection>1</redirection>0 si le nombre de redirection est bon
errorUne erreur s'est produite<error>Invalid URL</error>Pas de champs erreur si réussi
qr_shortAddresse du code QR pour le lien court<qr_short>http://safe.m/static/images/qr/1-safe.gif</qr_short> 
qr_longAddresse du code QR pour l'adresse finale<qr_long>http://safe.mn/static/images/qr/1.gif</qr_long> 

text

les champs sont séparés par un saut de ligne \n.

ParamètreSignificationValeur possibleCommentaire
urlLien longurl: http://www.reviews-web-hosting.com/ 
clicksNombre de clics sur le lien courtclicks: 1201Integer
referersNombre de clics par domaine d'originereferers: "Direct Access/Applications": 1151 "baidu.com": 2 
countriesNombre de clics par pays d'originecountries: "United States": 851 "China": 94 
filetypeType de fichier potentiellement dangereuxfiletype: application/x-dosexecEmpty if safe
virusNom du virusvirus: Eicar-Test-SignatureVide si aucun virus
dangerousSite dangereuxdangerous: Spyware/Malware/AdwareVide si sûr
partialTéléchargement incompletpartial: 10 si le téléchargement est complet
unreachablePage inaccessibleunreachable: 10 si la page est disponible
activexNom de l'ActiveX dangereuxactivex: 00000000-0000-0000-0000-000000000000 CnBabe AdwareVide si sûr
xssCross-Site scriptingxss: 10 si le lien est sûr
categoryType de contenucategory: AdultVide si sûr
redirectionTrop de redirectionsredirection: 10 si le nombre de redirection est bon
errorUne erreur s'est produiteerror: Invalid URLPas de champs erreur si réussi
qr_shortAddresse du code QR pour le lien courthttp://safe.m/static/images/qr/1-safe.gif 
qr_longAddresse du code QR pour l'adresse finalehttp://safe.mn/static/images/qr/1.gif 

Exemples

Réussie:

http://safe.mn/api/info?url=http://safe.mn/1&format=xml
<?xml version='1.0' ?>
<data>
 <activex></activex>
 <category></category>
 <clicks>1246</clicks>
 <countries>
 <country name="United States" clicks="851" />
 <country name="China" clicks="94" />
 <country name="Romania" clicks="53" />
 <country name="Russian Federation" clicks="46" />
 <country name="Japan" clicks="32" />
 <country name="Germany" clicks="24" />
 <country name="Taiwan" clicks="23" />
 <country name="Netherlands" clicks="20" />
[...]
 </countries>
 <download></download>
 <filetype></filetype>
 <google></google>
 <redirection></redirection>
 <referers>
 <referer clicks="1151" domain="Direct Access/Applications" />
 <referer clicks="73" domain="safe.mn" />
 <referer clicks="2" domain="192.168.1.75" />
 <referer clicks="2" domain="win.mail.ru" />
 <referer clicks="2" domain="baidu.com" />
 <referer clicks="1" domain="znatok.biz" />
 <referer clicks="1" domain="digifur.com" />
 <referer clicks="1" domain="www.ipark.cn" />
[...]
 </referers>
 <unreachable>0</unreachable>
 <url>http://www.amazon.com/gp/product/1430224258/ref=s9_intb_gw_i1?pf_rd_m=ATVPDKIKX0DER
&pf_rd_s=center-2&pf_rd_r=10DQS8RKGF8F4G84WJBD&pf_rd_t=101&pf_rd_p=470938631
&pf_rd_i=507846</url>
 <virus></virus>
 <xss></xss>
 <qr_short>http://safe.mn/static/images/qr/1-safe.gif</qr_short>
 <qr_long>http://safe.mn/static/images/qr/1.gif</qr_long>
</data>

Erreur:

http://go2.gs/api/info?url=foo&format=json
{"error":"Invalid URL"}

Haut