Authentification et scopes

Envoyez votre clé via X-API-Key: YOUR_API_KEY ou Authorization: Bearer YOUR_API_KEY. Une clé valide, un abonnement actif et le scope requis sont nécessaires. Les quotas, limites de débit et journaux d’utilisation s’appliquent à tous ces endpoints.

Conservez la clé dans la configuration secrète de votre serveur. Appelez l’API depuis votre backend : ne publiez jamais une clé secrète dans le JavaScript du frontend, une application distribuée, une URL, un dépôt ou des journaux. Les exemples utilisent uniquement YOUR_API_KEY.

• articles:read : articles, attribution intégrée et profils publics des auteurs.
• site:read : identité canonique du site / éditeur.
• legal_categories:read : catalogue autonome GET /api/v1/legal-categories.

Les plans donnant accès à articles:read proposent aussi site:read. Les permissions des clés existantes ne sont pas élargies automatiquement : créez une nouvelle clé avec les deux scopes depuis l’espace développeur, remplacez-la côté serveur, puis révoquez l’ancienne après vérification.

Codes usuels : 401 clé absente/invalide ; 403 scope absent, clé inactive/révoquée ou abonnement inactif ; 404 ressource introuvable ; 429 quota ou limite de débit dépassé.

Articles et attribution

GET /api/v1/articles et GET /api/v1/articles/{id} — scope articles:read.

La liste retourne {success, data: [...], meta} ; le détail retourne {success, data: {...}}. La pagination conserve current_page, last_page, per_page et total. Utilisez page, per_page (15 par défaut, de 1 à 50) et le filtre facultatif q. Une recherche non vide ajoute meta.search.

Les champs historiques id, title, slug, intro, content, main_picture et published_at restent présents. Chaque article inclut également :

{
  "author_id": 1,
  "author": {"id": 1, "name": "Avocats.cd", "slug": "avocats-cd"},
  "category_ids": [1],
  "categories": [{"id": 1, "name": "Travail", "slug": "travail"}]
}

Les catégories intégrées aux articles sont incluses sous articles:read et ne nécessitent pas le scope legal_categories:read. Les identifiants correspondent au catalogue des catégories juridiques. Un article peut n’avoir aucune catégorie ([]). Si l’auteur manque, author_id et author valent null.

Les auteurs de contenu sont indépendants des comptes administrateurs. Les anciens articles sont attribués à l’auteur public Avocats.cd ; les données de connexion et coordonnées privées ne sont pas exposées.

curl --fail-with-body -sS -H 'Accept: application/json' \
  -H 'X-API-Key: YOUR_API_KEY' 'https://avocatscdlara.kasaiconnect.com/api/v1/articles?per_page=15&page=1'

curl --fail-with-body -sS -H 'Accept: application/json' \
  -H 'X-API-Key: YOUR_API_KEY' 'https://avocatscdlara.kasaiconnect.com/api/v1/articles/1'

Auteurs publics

GET /api/v1/authors et GET /api/v1/authors/{id} — scope articles:read.

Les auteurs exposent uniquement id, name, slug, bio, photo_url et profile_url. Les trois derniers champs peuvent être null. La liste utilise la même enveloppe de pagination que les articles, avec page et per_page. Elle est triée par nom puis identifiant.

{
  "success": true,
  "data": {
    "id": 1, "name": "Avocats.cd", "slug": "avocats-cd",
    "bio": null, "photo_url": null, "profile_url": "https://avocats.cd"
  }
}

curl --fail-with-body -sS -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' 'https://avocatscdlara.kasaiconnect.com/api/v1/authors'

curl --fail-with-body -sS -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' 'https://avocatscdlara.kasaiconnect.com/api/v1/authors/1'

Site API : identité canonique de l’éditeur

GET /api/v1/site — scope requis : site:read.

Ce profil, géré par l’équipe Avocats.cd, est la source de référence pour les intégrations et la syndication, notamment KongoKafe. Il permet de découvrir l’identité et les logos de l’éditeur sans règles spécifiques codées en dur.

• name, slug, short_description, description : identité éditoriale.
• url : site canonique ; contact.email et contact.phone : coordonnées explicitement publiques.
• language et country : langue par défaut et code pays.
• branding.logo, logo_dark (fond sombre), logo_light (fond clair), logo_square et favicon : URL absolue ou null si absent.
• social_links : liens actifs ordonnés, avec platform, label, username et url HTTP/HTTPS. La plateforme other utilise un libellé personnalisé.
• content.articles_url, content.articles_api et content.authors_api : URL de découverte.

Les descriptions, coordonnées et variantes non renseignées restent null. Aucun token OAuth, identifiant administrateur, chemin de stockage ou secret n’est publié. Exemple du profil initial, avant personnalisation :

{
    "success": true,
    "data": {
        "name": "Avocats.cd",
        "slug": "avocats-cd",
        "short_description": null,
        "description": null,
        "url": "https://avocats.cd",
        "contact": {
            "email": null,
            "phone": null
        },
        "language": "fr",
        "country": "CD",
        "branding": {
            "logo": "https://avocats.cd/images/avocatscd_logo.png",
            "logo_dark": null,
            "logo_light": null,
            "logo_square": null,
            "favicon": null
        },
        "social_links": [],
        "content": {
            "articles_url": "https://avocats.cd/index.php/blog",
            "articles_api": "https://avocatscdlara.kasaiconnect.com/api/v1/articles",
            "authors_api": "https://avocatscdlara.kasaiconnect.com/api/v1/authors"
        }
    }
}

curl --fail-with-body -sS -H 'Accept: application/json' \
  -H 'X-API-Key: YOUR_API_KEY' 'https://avocatscdlara.kasaiconnect.com/api/v1/site'

Pour une source de syndication, utilisez au minimum articles:read et site:read. Remplacez les identifiants d’exemple par ceux renvoyés par l’API.