データスコアリング

会社やDealを決定的な結果で評価するデータスコアリングAPIです。

概要

データスコアリングには POST /v1/score エンドポイントと、その動作を確認できるPlaygroundが含まれます。POST /v1/score を使うと、company または deal をスコアリングし、構造化された理由とともに決定的なレスポンスを取得できます。同じ正規化入力と同じアルゴリズムバージョンであれば、スコアリング結果は同一になります。会社またはDealのレコードを評価し、数値スコアと構造化された理由を返します。

認証

外部連携では Authorization: Bearer <access_token> を使います
会社スコアリングでは companies:read 権限が必要です
Dealスコアリングでは cases:read 権限が必要です
Sanka内部ツールでは X-Workspace-Code による認証も使えます

対応範囲

v1では object_type=company と object_type=deal に対応しています
同じ正規化入力と同じアルゴリズムバージョンなら結果は同じになります
レスポンスには dimensions、reasons、explanation が含まれます

返される内容

各レスポンスには主に次の情報が含まれます。

score: 0 から 100 までの整数
band: low、medium、good、very_good
dimensions: 重み付きの評価軸
reasons: 構造化された根拠
explanation: 自然文による簡潔な要約
algorithm_version、input_hash、output_hash: 結果を固定的に追跡するための情報

会社をスコアリングする

curl -X POST "https://api.sanka.com/v1/score" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "object_type": "company",
    "record_id": "11111111-2222-3333-4444-555555555555"
  }'

会社スコアでは、企業属性の適合度とレコード品質のシグナルを組み合わせて評価します。

Dealをスコアリングする

curl -X POST "https://api.sanka.com/v1/score" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "object_type": "deal",
    "record_id": "66666666-7777-8888-9999-000000000000"
  }'

Dealスコアでは、取引の整備状況、直近の活動状況、パイプライン進行度、関連する会社データの品質を組み合わせて評価します。

結果の見方

レスポンス例:

{
  "data": {
    "object_type": "deal",
    "record_id": "<record_uuid>",
    "snapshot_id": "<snapshot_uuid>",
    "algorithm_key": "deal_score_v1",
    "algorithm_version": "v1",
    "input_hash": "<sha256>",
    "output_hash": "<sha256>",
    "score": 78,
    "band": "good",
    "dimensions": [],
    "reasons": [],
    "explanation": "Strong qualification hygiene with room to improve activity freshness."
  },
  "message": "ok",
  "ctx_id": "<ctx_id>"
}

企業と取引レコードの両方のリクエストは、このページのOpenAPIリファレンスにあるPlaygroundでも試せます。

Previousデータエンリッチメント NextSankaパートナー