Zijob - API pour développeurs

Introduction

Nous avons mis en place une API publique permettant de faire une recherche sur l'ensemble des offres d'emploi, de se connecter à un compte recruteur et de publier des offres. Vous avez la possibilité d'utiliser notre API pour créer des applications web, logicielles ou sur téléphone mobile. N'hésitez pas à nous contacter si vous avez des questions et ou si vous souhaitez que l'on fasse la promotion de votre application.

Exemples d'application

une application androïd pour publier des annonces, une passerelle afin d'exporter directement les annonces de votre intranet/extranetl vers Zijob, une application de type Adobe Air pour publier et rechercher des annonces sur votre ordinateur, une intégration de nos annonces dans votre aggrégateur d'offres d'emploi en ligne etc...

Application Test

Une application de test est disponible. Elle vous permet après connection à votre compte membre de tester l'ensemble des méthodes décrites dans l'API de manière simple grâce à des formulaires. C'est un bon tutoriel pour comprendre le fonctionnement de l'API et l'authentification d'une application.

Utiliser l'application TEST

Authentification

Notre API contient plusieurs méthodes qui nécessitent une authentification préalable pour avoir accès et publier certaines données. C'est le cas par exemple des fonctionnalités réservées aux recruteurs connectés comme par exemple la publication, l'édition et la supression d'offre d'emplois. Certaines méthodes n'ont pas besoin d'authentification, c'est le cas par exemple de la recherche. Pour gérer l'authentification, nous utilisons un protocole connu appelé OAuth utilisé notamment par Twitter.

Plus d'informations sur l'authentification OAuth

Langage et Urls

L'url pour interroger l'API dépend de la méthode appelée ainsi que de la langue choisie. Pour faire une requête sur le site français, il faudra donc utiliser une url commençant par http://www.zijob.fr. Sur la page dédiée à chaque méthode, vous trouverez l'url permettant d'interroger cette méthodes via l'API, toutes ces urls commencent avec /api/.

Exemple

http://www.zijob.fr/api/account/create + arguments en POST => crée un utilisateur sur le site français de zijob (zijob.fr)

Sandbox

Vous avez la possibilité de tester l'API en utilisant la sandbox. Le site et la sandbox ne partageant pas la même base de données, les tests que vous effectuerez n'auront pas de répercusions sur le vrai site. Vous pouvez utiliser ce "bac à sable" avant de passer votre application en production. Il vous suffira de changer l'url des méthodes utilisées.

Pour interroger l'api en mode test, veuillez utiliser http://sandbox.zijob.fr au lieu de http://www.zijob.fr

L'application test est aussi disponible sur la sandbox : http://sandbox.zijob.fr/api/test

Formats

L'api est de type REST (plus d'informations sur REST)

Les réponses de l'API sont encodées en UTF-8 et le format de retour est basé sur le paramètre format disponible en entrée sur chaque méthode. La réponse est disponible en plusieurs formats : xml, json et array. Le format par défaut est xml.

Paramètres

A chaque méthode sont associées des paramètres d'entrée et des paramètres de sortie (réponse). Chaque paramètre est détaillé sur une page dédiée.

Voir la liste des paramètres

Messages d'Erreur

Lorsqu'une méthode renvoie une erreur, elle est définie par un code et un message dans la langue choisie. Chaque code d'erreur est détaillé sur une page dédiée.

Voir la liste des messages d'erreur

Méthodes

Les méthodes sont listées dans la colonne de droite de cette page afin de faciliter la navigation. Pour chaque méthode, vous trouverez une page détaillée (en anglais) indiquant les paramêtres d'entrée et un exemple de réponse.