メインコンテンツへスキップ

​
はじめに

POST /v1/score を使うと、company または deal をスコアリングし、構造化された理由とともに決定的なレスポンスを取得できます。 同じ正規化入力と同じアルゴリズムバージョンであれば、スコアリング結果は同一になります。

​
返される内容

各レスポンスには主に次の情報が含まれます。
  • 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>"
}
会社とDealの両方のリクエストは、APIリファレンス → データスコアリング のPlaygroundでも試せます。