KARABA / Docs
Dashboard

Guides d'intégration

Trois façons courantes d'intégrer KARABA, et un exemple multi-langage pour le premier appel.

Plateforme avec sa propre base — publier une offre

  1. 01Poussez votre pool candidats via POST /v1/profiles (JSON) ou /v1/profiles/cv (PDF)
  2. 02À chaque offre publiée par une de vos entreprises clientes, appelez POST /v1/jobs
  3. 03Le matching et le Trust Score se calculent automatiquement sur votre pool
  4. 04Affichez matches[] (score + Trust Score) dans votre interface entreprise

Cabinet RH — qualifier des candidats

  1. 01Ingérez vos candidats avec compétences, expériences, formations
  2. 02Calculez le Trust Score via POST /v1/trust/score
  3. 03Lisez le breakdown (Identity 30% + References 40% + Skills 30%) pour qualifier
  4. 04Exportez les profils qualifiés en JSON

Diffusion WhatsApp & suivi des réponses

  1. 01Après POST /v1/jobs, déclenchez POST /v1/jobs/{id}/broadcast
  2. 02Les candidats matchés reçoivent l'offre avec deux boutons : Intéressé(e) / Non merci
  3. 03Enregistrez un webhook job.candidate_replied pour réagir en temps réel
  4. 04Suivez le taux de réponse global via GET /v1/jobs/{id}/analytics

Exemple — recherche de candidats

TOKEN=$(curl -s -X POST https://platform.api.staging.karaba.africa/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"grant_type":"client_credentials","client_id":"sk_sandbox_xxx","client_secret":"your_secret","scope":"match:read"}' \
  | jq -r '.access_token')

curl -X POST https://platform.api.staging.karaba.africa/v1/match/query \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"Ingénieur Python Abidjan","limit":5}'