Chargement. Veuillez patienter...
Retour à l'accueil

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.

Vous êtes propriétaire d'entreprise,
Assurez votre visibilité sur Internet !

Référencez votre entreprise et publiez vos informations utiles, produits et services, photos et actualités sur CONGOFINDER. Reliez également votre visibilité aux réseaux sociaux.