패싯

패싯 API는 버킷의 각 메타데이터 키별로 상위 N개 값(카운트 포함)을 반환합니다. 필터 드롭다운, 데이터셋 형태 점검, dirty data 감지에 유용합니다.

요청

bashPOST /v1/buckets/{bucket_id}/facets

예시

bashcurl -X POST https://api.schift.io/v1/buckets/{bucket_id}/facets \
  -H "Authorization: Bearer $SCHIFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": ["tag", "doc_type", "source_url"],
    "limit_per_field": 10
  }'

응답

json{
  "bucket_id": "bkt_abc",
  "facets": {
    "tag":      [{"value": "urgent", "count": 142}, {"value": "draft", "count": 87}],
    "doc_type": [{"value": "policy", "count": 320}, {"value": "spec", "count": 145}],
    "source_url": [...]
  },
  "totals": {"tag": 229, "doc_type": 465, "source_url": 712}
}