KARABA / Docs
← Match
Pool inline

Matching stateless

Le pool inline transforme l'API en fonction pure : vous envoyez vos candidats directement dans la requête, Karaba les score en mémoire, et retourne les résultats. Rien n'est stocké, aucun identifiant n'est conservé côté Karaba.

🔒
Garantie de confidentialité

Aucune donnée du champ candidates n'est écrite en base de données. Le traitement est entièrement en mémoire. Les external_id sont retournés dans la réponse mais ne sont jamais journalisés, ni dans les AuditLogs, ni dans les analytics.

Données stockées Trust Score Diffusion WhatsApp Setup requis RGPD-friendly Intégration immédiate

Endpoint

POST/v1/match/runmatch:read

Match stateless — candidats envoyés dans la requête, aucune donnée conservée

Requête
{
  "job": {
    "title": "Développeur React senior",
    "skills_required": [
      "react",
      "typescript"
    ],
    "location": "Lomé",
    "experience_min": 3
  },
  "pool": {
    "type": "inline",
    "candidates": [
      {
        "external_id": "c_001",
        "skills": [
          "react",
          "typescript",
          "node"
        ],
        "experience_years": 4,
        "location": "Lomé"
      },
      {
        "external_id": "c_002",
        "skills": [
          "vue",
          "python"
        ],
        "experience_years": 2,
        "location": "Abidjan"
      },
      {
        "external_id": "c_003",
        "skills": [
          "react",
          "graphql",
          "typescript"
        ],
        "experience_years": 6,
        "location": "Lomé",
        "seniority": "senior"
      }
    ]
  },
  "limit": 5
}
Réponse
{
  "match_id": "inline_3f9a12c4e8b1",
  "pool_type": "inline",
  "total_results": 2,
  "results": [
    {
      "external_id": "c_003",
      "match_score": 0.96,
      "trust_score": null,
      "location": "Lomé",
      "experience_years": 6,
      "skills": [
        "react",
        "graphql",
        "typescript"
      ]
    },
    {
      "external_id": "c_001",
      "match_score": 0.87,
      "trust_score": null,
      "location": "Lomé",
      "experience_years": 4,
      "skills": [
        "react",
        "typescript",
        "node"
      ]
    }
  ],
  "cached": false
}

Champs d'un candidat inline

ChampTypeRequisDescription
external_idstring✓ ouiIdentifiant dans votre système — jamais stocké par Karaba
skillsstring[]nonListe de compétences libres
experience_yearsintegernonAnnées d'expérience totales
locationstringnonVille ou pays
senioritystringnonjunior / mid / senior / lead
full_namestringnonRetourné dans la réponse mais non indexé
headlinestringnonTitre professionnel

Cas d'usage typiques

  • • Partenaire soumis à une réglementation locale interdisant le transfert de données personnelles
  • • Concurrent indirect qui veut utiliser le matching Karaba sans exposer sa base
  • • Test rapide de l'algorithme sur vos propres données avant de choisir un modèle d'intégration
  • • Matching ponctuel sur un lot de candidats sans besoin de persistance