Documentation API foe.hn

Plugin WordPress foe.hn

Fonctionnalités

• Génére une url courte pour chaque article ou chaque page
• Génére une url courte pour tous les anciens articles si vous le souhaitez
• Envoi un twitt avec l'url
• Le plugin est également compatible avec tr.im, is.gd, tinyurl.com, bit.ly, etc ...

Capture d'écran

Téléchargement

• Cela se passe ici

API foe.hn

Fonctionnalités

• Génére ou récupère l'url raccourcie
• Donne quelques statistiques sur vos liens : les plus cliqués, les nouveaux, ...
• Formats de sortie : JSON, XML, texte
• Authentification par identifiant et mot de passe

Utilisation

Vous devez envoyer les paramètres à l'adresse http://yoursite.com/api.php par GET ou POST. Ces paramètres sont :

• Une paire username / password valide
• La requête action: "shorturl" (pour obtenir un lien court), "expand" (pour obtenir l'url longue d'une url courte), "url-stats" (pour obtenir des stats sur une url) ou "stats" (pour obtenir des stats sur vos liens)
• Avec action = "shorturl" :
  • l' url à raccourcir
  • le mot clé facultatif keyword pour une url personnalisée
  • Format de sortie format: "json", "xml" ou "simple"
• Avec action = "expand" :
  • l'url raccourcie shorturl pour afficher l'url longue (peut-être 'abc' ou 'http://site/abc')
  • Format de sortie format: "json", "xml" ou "simple"
• Avec action = "url-stats" :
  • l'url raccourcie shorturl pour laquelle vous souhaitez avoir des stats (peut-être 'abc' ou 'http://site/abc')
  • Format de sortie format: "json" ou "xml"
• Avec action = "stats" :
  • filter: "top", "bottom" , "rand" ou "last"
  • limit : le maximum de lien à renvoyer
  • Format de sortie format: "json" ou "xml"

Exemple de réponse

<result>
	<url>
		<id>62019439011</id>

		<keyword>shorter</keyword>
		<url>http://somereallylongurlyouneedtoshrink.com/</url>
		<date>2009-06-23 18:08:07</date>
		<ip>127.0.0.1</ip>

	</url>
	<status>success</status>
	<message>http://somereallylongurlyouneedtoshrink.com/ (ID: shorter) added to database</message>
	<shorturl>http://yoursite.com/shorter</shorturl>

</result>

Exemple d'utilisation en php

<?php
/*
 * Exemple d'utilisation de l'API en php, mais d'autres
 * languages sont utilisables. 
 */

// Vos paramètres d'authentification
$username = 'joe';
$password = '123456';

// Les paramètres de la requête
$url = 'http://www.google.fr/machin-truc-budile'; // L'url à raccourcir
$keyword = 'ozh';                // le mot clé optionel
$format = 'json';                // le format: 'json', 'xml' or 'simple'

$api_url = 'http://foe.hn/api.php';

// CURL session
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_HEADER, 0);            
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(
        'url'      => $url,
        'keyword'  => $keyword,
        'format'   => $format,
        'action'   => 'shorturl',
        'username' => $username,
        'password' => $password
    ));

$data = curl_exec($ch);
curl_close($ch);

// Votre traitement des résultats, dans cet exemple un simple affichage
echo $data;

?>


Demander une clef API

Ce service est gratuit, mais afin d'éviter tout spam, nous vous demandons de motiver votre demande et de ne pas utiliser ce service de manière abusive.

Demande d'une clé foe.hn

Votre nom
Votre email
Pourquoi souhaitez vous une clé ?
Antispam : quelle est l'url de ce site ?

 

 

Informations éditeur

Nous mettons gratuitement ce service à disposition, cela nous permet de valider et tester certains choix technologiques. Même si nous apportons tout notre savoir-faire à ce service et que nous avons tout intérêt à ce qu'il opère correctement, nous ne fournissons pas de garantie de disponibilité ni de fonctionnement. Enfin, tout usage illicite, pénalisant le bon fonctionnement de ce service pourra être limité ou bloqué sans préavis.

Complément à venir ...