Documentation API - CongoFinder
Documentation API CongoFinder
Introduction
Bienvenue sur l'API de CongoFinder. Cette API vous permet d'intégrer les données de CongoFinder dans vos propres applications.
L'API est de type RESTful et retourne des réponses au format JSON.
Authentification
Toutes les requêtes API nécessitent une authentification via une clé API (api_key).
Vous pouvez passer la clé de trois manières :
- Via un paramètre de requête :
?api_key=VOTRE_CLE - Via l'en-tête Authorization :
Authorization: Bearer VOTRE_CLE - Via le corps de la requête (pour POST/PUT) :
{"api_key": "VOTRE_CLE", ...}
Votre clé API est disponible dans votre profil utilisateur.
Publications (Posts)
Gérez les actualités, annonces et publications générales.
GET /api/posts
Paramètres de requête :
type: Type de post (ex:post,event). Séparez par des virgules pour plusieurs types.q: Recherche par nom ou titre.category: ID de la catégorie.contact_id: ID de l'entreprise/contact associé.limit: Nombre d'éléments par page (défaut: 50, max: 100).page: Numéro de la page.
Exemple de réponse :
{
"status": "success",
"data": [
{
"id": 1,
"name": "Titre du post",
"type": "post",
"content": "Contenu...",
"created": "2024-01-21 12:00:00"
}
],
"meta": {
"total_items": 120,
"total_pages": 3
}
}POST /api/posts/create
Corps de la requête (JSON) :
{
"name": "Nouveau Post",
"content": "Description détaillée...",
"contact_id": 123,
"categories_ids": [1, 2]
}Produits
Gérez le catalogue de produits.
GET /api/products
Paramètres : q, category, supplier_id, limit, page.
POST /api/products/create
Champs requis : name, selling_price, supplier_id.
Offres d'emploi
Gérez les recrutements.
GET /api/jobs
Paramètres : q, category, contact_id.
POST /api/jobs/create
Champs requis : name, start_date, salary, required_skills.
Entreprises & Contacts
L'API pour les entreprises et les contacts est également disponible sur les endpoints /api/companies et /api/contacts.
500
Erreur interne du serveur !
Une erreur interne s’est produite. Veuillez réessayer plus tard.