Aide

Aide
Guide Chien Perdu
Guide Chien Trouvé
Affiche
Soutenir le site
Statistiques
Développeurs
Contact

Important

Conditions d'utilisation
Conditions de vente

Développeurs

Afin d'assurer une diffusion maximum des annonces, vous pouvez utiliser les méthodes suivantes pour afficher les annonces sur votre site/blog/forum : flux RSS, fichier CSV, widget JS, API JSON...

Notez que pour protéger les données personnelles des internautes, les noms, prénoms, e-mail, no de téléphone des publicateurs des annonces ne sont pas diffusés.

Vous n'êtes pas autorisé à sauvegarder de manière durable ces annonces, seule leur diffusion est autorisée. Une fois l'annonce supprimée sur le site, veuillez ne plus l'afficher non plus.

Flux RSS

Le flux RSS des dernières annonces est disponible à l'adresse suivante :
http://www.chien-perdu.org/items_xml.php

Il est possible de filtrer le flux avec les variables (facultatives) suivantes :
isl : "1" pour les chiens perdus ou "0" pour les chien trouvés.
ism : "1" pour les males ou "0" pour les femelles.
race : une race de chien (inspirez-vous de la liste des races pour utiliser la syntaxe exacte).
cp : un ou plusieurs codes postaux séparés par des virgules (max 10).
dept : un numéro de département français (01, 02, 03 ... 95 puis 971, 972, 973, 974 pour l'Outre Mer).
cn : code du pays (fr, be, ch, lu...).
Exemples :
     - les annonces du département 74 http://www.chien-perdu.org/items_xml.php?dept=74
     - tous les boxers http://www.chien-perdu.org/items_xml.php?race=boxer
     - les chiens perdus du département 74 http://www.chien-perdu.org/items_xml.php?isl=1&dept=74

Fichier CSV (Excel)

Vous pouvez aussi récupérer la liste des dernières annonces au format CSV à l'adresse ci-dessous :
http://www.chien-perdu.org/items_xls.php

Notez que ce fichier ne présente qu'une liste des dernières annonces. Pour disposer d'une liste complète, veuillez en faire la demande par e-mail.

Il est possible de filtrer le fichier avec les variables (facultatives) suivantes :
isl : "1" pour les chiens perdus ou "0" pour les chien trouvés.
ism : "1" pour les males ou "0" pour les femelles.
race : une race de chien (inspirez-vous de la liste des races pour utiliser la syntaxe exacte).
cp : un ou plusieurs codes postaux séparés par des virgules (max 10).
dept : un numéro de département français (01, 02, 03 ... 95 puis 971, 972, 973, 974 pour l'Outre Mer).
cn : code du pays (fr, be, ch, lu...).

Widget JavaScript

Ce widget affiche via JS une liste d'annonces dans un tableau HTML. Des classes CSS sont utilisées pour vous permettre d'adapter ensuite au mieux l'affichage à la charte graphique de votre site.
L'utilisation du widget nécessite une clef personnelle (wid). Veuillez en faire la demande par e-mail.

Il est possible de filtrer les annonces du widget avec les variables (facultatives) suivantes :
wid : votre clef personnelle.
v : le numéro de version du widget, indiquez 1.
isl : "1" pour les chiens perdus ou "0" pour les chien trouvés.
ism : "1" pour les males ou "0" pour les femelles.
race : une race de chien (inspirez-vous de la liste des races pour utiliser la syntaxe exacte).
cp : un ou plusieurs codes postaux séparés par des virgules (max 10).
dept : un numéro de département français (01, 02, 03 ... 95 puis 971, 972, 973, 974 pour l'Outre Mer).
cn : code du pays (fr, be, ch, lu...).
v : "1" pour indiquer la version du widget
inc_no_picture : "0" pour ne voir que les annonces avec photo
picture_size : taille de l'image dans l'annonce, "small" ou "medium"
limit : nombre d'annonces à afficher (max 30)
charset : "iso-8859-1" ou "utf-8"

Exemple :
<script src="http://www.chien-perdu.org/apijs?wid=&v=1"></script>

API JSON

L'utilisation de l'API nécessite une clef personnelle (k) et une clef secrète (secret). Veuillez en faire la demande par e-mail.

Connexion

La connexion à l'API se fait à l'adresse : http://www.chien-perdu.org/api
Vous devez transmettre à l'API le paramètre v qui indique le numéro de version de l'API. A date, il s'agit de la version 2.
Indiquez donc : http://www.chien-perdu.org/api?v=2
Les autres paramètres vont être communiqués à l'API via le paramètre data. Ce paramètre est un tableau de variables au format JSON qui est ensuite encodé en base64.

Commencez par créer un tableau des différentes variables que vous souhaitez communiquer à l'API. Les variables suivantes sont obligatoires :
k : votre clef personnelle de connexion à l'API
datetime : la date et l'heure de la requête au format AAAA-MM-JJ HH:MM:SS
client_v : la version de votre application au format x.y
sign : la signature de votre requête. Il s'agit du SHA1 des éléments suivants : datetime k secret (séparés par des espaces)

En plus des variables ci-dessus, vous allez pouvoir ajouter de nouvelles variables pour indiquer à l'API la nature de votre requête.
method : le type de données que vous souhaitez recevoir. Cf ci-dessous.

Récupérer une liste d'annonces

Indiquez la méthode item_selects pour recevoir une liste d'annonces.
Vous pouvez ensuite préciser dans un tableau args les critères suivants pour filtrer les annonces :

limit : le nombre d'annonces à retourner. Maximum 50. Par défaut 30.

page : la page de résultat à afficher par rapport à la limite indiquée ci-dessus.

type : "lost" pour les chiens perdus ou "found" pour les chien trouvés.

is_returned : "true" pour les chiens retrouvés.

country : le code du pays (fr, be, ch, lu...). Retrouvez la liste des pays grâce à la méthode local_selects.

region : le code de la région (sous partie d'un pays). Pour la france, c'est le code du département. Cet argument n'a de sens que lorsqu'il est associé à un code pays. Retrouvez la liste des régions grâce à la méthode local_selects.

zip : un code postal. Cet argument n'a de sens que lorsqu'il est associé à un code pays.

geo_lat, geo_lng, geo_dis : latitude, longitude et rayon en km autour duquel filtrer les annonces.

sex : "male" pour les males ou "female" pour les femelles. Il est également possible d'indiquer "male_or_unknown" ou "female_or_unknown" pour récupérer également les annonces pour lesquelles le sexe est inconnu. Pour un chien perdu, le propriétaire connaît le sexe de son chien. Par contre, dans le cas d'un chien trouvé ou juste aperçu, la personne ne sait pas toujours indiquer avec certitude le sexe de l'animal.

race : l'id d'une race. Retrouvez la liste des races grâce à la méthode option_selects.

sizing : l'id d'une taille. Retrouvez la liste des tailles grâce à la méthode option_selects.

fur_size : l'id d'une taille de pelage. Retrouvez la liste des tailles de pelage grâce à la méthode option_selects.

fur_drawing : l'id d'un motif de pelage. Retrouvez la liste des motifs de pelage grâce à la méthode option_selects.

d_found_after : trouvé après une date au format aaaa-mm-jj.

d_lost_before : perdu avant une date au format aaaa-mm-jj.

Récupérer une annonce en particulier

Indiquez la méthode item_select pour recevoir une annonce en particulier. Vous devez ensuite préciser l'identifant de l'annonce dans la variable id

Récupérer la liste des zones géographiques

Indiquez la méthode local_selects pour recevoir la hiérarchie des zones géographiques.

Publier une annonce (à venir)

Indiquez la méthode item_insert pour publier une annonce.

Récupérer la liste des attributs des annonces

Indiquez la méthode option_selects pour recevoir la liste des attributs d'une annonce (races, tailles, couleurs, pelages...).