辞書マッチング機能

{
  "value": "検出対象のワード",
  "metadata": {
    "key": "value"  // 任意のメタデータ
  }
}

# ETagを取得
ETAG=$(curl -s -I https://api.pii-fi.com/api/policy/active \
  -H "Authorization: Bearer YOUR_API_KEY" | grep -i etag | awk '{print $2}' | tr -d '\r')

# If-Matchヘッダー付きで辞書を作成
curl -X POST https://api.pii-fi.com/api/policy/dictionaries \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "If-Match: $ETAG" \
  -d '{
    "id": "dict.companies",
    "name": "会社名辞書",
    "entity_type": "JPII_COMPANY_NAME",
    "priority": 90,
    "entries": [
      {"value": "トヨタ自動車", "metadata": {"industry": "自動車"}},
      {"value": "ソニー", "metadata": {"industry": "電機"}},
      {"value": "任天堂", "metadata": {"industry": "ゲーム"}}
    ]
  }'

# ETag取得後に実行
curl -X POST https://api.pii-fi.com/api/policy/dictionaries \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "If-Match: $ETAG" \
  -d '{
    "id": "dict.prohibited",
    "name": "禁止ワード辞書",
    "entity_type": "JPII_PROHIBITED_WORD",
    "priority": 100,
    "normalize": false,
    "entries": [
      {"value": "ProjectX"},
      {"value": "極秘プロジェクト"},
      {"value": "CodeName-Alpha"}
    ]
  }'

# ETag取得後に実行
curl -X POST https://api.pii-fi.com/api/policy/dictionaries \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "If-Match: $ETAG" \
  -d '{
    "id": "dict.products",
    "name": "製品名辞書",
    "entity_type": "JPII_PRODUCT_NAME",
    "priority": 90,
    "entries": [
      {"value": "Bestllam", "metadata": {"type": "LLM"}},
      {"value": "ChatStream", "metadata": {"type": "Chat"}},
      {"value": "MotionVox", "metadata": {"type": "Voice"}}
    ],
    "fuzzy": true,
    "fuzzy_threshold": 0.8,
    "normalize": true
  }'

// ファジーマッチの場合
{
  "entity_type": "JPII_PRODUCT_NAME",
  "original_text": "Bestlam",
  "confidence_score": 0.88,
  "detection_method": "dictionary_fuzzy",
  "masking_details": {
    "replacement_text": "<製品名>",
    "original_entry": "Bestllam",
    "matched_text": "Bestlam"
  }
}

curl https://api.pii-fi.com/api/policy/dictionaries \
  -H "Authorization: Bearer YOUR_API_KEY"

# ETag取得後に実行
curl -X POST https://api.pii-fi.com/api/policy/dictionaries/dict.companies/entries \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "If-Match: $ETAG" \
  -d '{
    "entries": [
      {"value": "パナソニック", "metadata": {"industry": "電機"}},
      {"value": "日立製作所", "metadata": {"industry": "電機"}}
    ]
  }'

# ETag取得後に実行
curl -X DELETE https://api.pii-fi.com/api/policy/dictionaries/dict.companies/entries \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "If-Match: $ETAG" \
  -d '{
    "values": ["パナソニック"]
  }'

# ETag取得後に実行
curl -X DELETE https://api.pii-fi.com/api/policy/dictionaries/dict.companies \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "If-Match: $ETAG"

import requests

class DictionaryManager:
    # base_url: デモ環境（本番環境では専用エンドポイントを提供）
    def __init__(self, api_key, base_url="https://api.pii-fi.com/api"):
        self.api_key = api_key
        self.base_url = base_url
        self.headers = {
            "Content-Type": "application/json",
            "Authorization": f"Bearer {api_key}"
        }

    def _get_etag(self):
        """アクティブポリシーのETagを取得"""
        response = requests.get(
            f"{self.base_url}/policy/active",
            headers=self.headers
        )
        return response.headers.get("ETag")

    def list_dictionaries(self):
        """辞書一覧を取得"""
        response = requests.get(
            f"{self.base_url}/policy/dictionaries",
            headers=self.headers
        )
        response.raise_for_status()
        return response.json()

    def create_dictionary(self, config):
        """辞書を作成"""
        etag = self._get_etag()
        response = requests.post(
            f"{self.base_url}/policy/dictionaries",
            headers={**self.headers, "If-Match": etag},
            json=config
        )
        response.raise_for_status()
        return response.json()

    def add_entries(self, dictionary_id, entries):
        """エントリを追加"""
        etag = self._get_etag()
        response = requests.post(
            f"{self.base_url}/policy/dictionaries/{dictionary_id}/entries",
            headers={**self.headers, "If-Match": etag},
            json={"entries": entries}
        )
        response.raise_for_status()
        return response.json()

    def delete_entries(self, dictionary_id, values):
        """エントリを削除"""
        etag = self._get_etag()
        response = requests.delete(
            f"{self.base_url}/policy/dictionaries/{dictionary_id}/entries",
            headers={**self.headers, "If-Match": etag},
            json={"values": values}
        )
        response.raise_for_status()
        return response.json()


# 使用例
manager = DictionaryManager("YOUR_API_KEY")

# ファジーマッチング有効の製品名辞書を作成
manager.create_dictionary({
    "id": "dict.products",
    "name": "製品名辞書",
    "entity_type": "JPII_PRODUCT_NAME",
    "priority": 90,
    "entries": [
        {"value": "Bestllam", "metadata": {"type": "LLM"}},
        {"value": "ChatStream", "metadata": {"type": "Chat"}}
    ],
    "fuzzy": True,
    "fuzzy_threshold": 0.8
})

# タイプミスを含むテキストで検出テスト
detect_response = requests.post(
    f"{manager.base_url}/detect",
    headers=manager.headers,
    json={
        "text": "弊社のBestlamとChatSteamをご紹介します",
        "deidentification_type": "replace"
    }
)
result = detect_response.json()
print(result["deidentified_text"])
# → "弊社の<製品名>と<製品名>をご紹介します"