KARABA / Docs

Jobs

Le point d'entrée pensé pour les plateformes qui publient déjà des offres pour leurs entreprises clientes. Une offre déclenche automatiquement le matching et le Trust Score sur votre pool — aucune requête manuelle à enchaîner.

POST/v1/jobsjobs:write

Publie une offre et lance le matching + Trust Score automatiques

Requête
{
  "title": "Développeur React senior",
  "description": "Mission de 6 mois, stack React/TypeScript.",
  "location": "Lomé, Togo",
  "contract_type": "CDD",
  "company_name": "Entreprise cliente",
  "external_job_id": "partner-job-128",
  "limit": 10
}
Réponse
{
  "job_id": 482,
  "external_job_id": "partner-job-128",
  "title": "Développeur React senior",
  "status": "matched",
  "total_matched": 3,
  "matches": [
    {
      "candidate_id": 91,
      "full_name": "Kofi Mensah",
      "match_score": 94.2,
      "trust_score": 81.5,
      "whatsapp_status": "not_sent"
    }
  ]
}
GET/v1/jobs/{id}jobs:read

Détail d'une offre et de ses matchs

Réponse
{
  "job_id": 482,
  "status": "matched",
  "total_matched": 3,
  "matches": [
    {
      "candidate_id": 91,
      "full_name": "Kofi Mensah",
      "match_score": 94.2,
      "trust_score": 81.5,
      "whatsapp_status": "not_sent"
    }
  ]
}
GET/v1/jobs/{id}/matchesjobs:read

Liste des candidats matchés, triés par score

Réponse
[
  {
    "candidate_id": 91,
    "full_name": "Kofi Mensah",
    "match_score": 94.2,
    "trust_score": 81.5,
    "whatsapp_status": "sent"
  }
]
GET/v1/jobs/{id}/analyticsanalytics:read

Répartition Trust Score, statut de diffusion, taux de réponse

Réponse
{
  "job_id": 482,
  "total_matched": 3,
  "trust_score_breakdown": {
    "low": 0,
    "medium": 1,
    "high": 1,
    "verified": 1,
    "average": 78.4
  },
  "whatsapp": {
    "not_sent": 0,
    "sent": 1,
    "failed": 0,
    "replied_interested": 2,
    "replied_declined": 0
  },
  "response_rate": 0.67
}