SaaS API가이드라인 Trial (데모)
규정 검수 결과 조회
trial 가이드라인의 규정 검수 결과를 정책별로 조회합니다.
규정 검수 결과 조회
규정 검수 실행 결과를 조회합니다. 검수가 비동기라 status 가 IN_PROGRESS 인 동안 폴링합니다.
HTTP 요청
GET /ai/guideline/trial/{trialId}/regulation?policyKey=metaAds인증 불필요 (permitAll).
Path Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
trialId | String | 예 | 세션 UUID |
Query Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
policyKey | String | 아니오 | metaAds (기본) / yakkiho / tiktokAds |
result 상태
result | 의미 |
|---|---|
null | 실행된 적 없음 |
status: IN_PROGRESS (+startedAt) | 검수 중 |
status: FAILED (+error) | 실패. 다시 실행하면 됩니다 |
status: high / low / pass | 완료. Python 원본 응답 그대로입니다 |
실행 시 contentHash 를 보냈다면 모든 상태(IN_PROGRESS·FAILED·완료)의 result 에 contentHash 가 함께 들어 있습니다. 보내지 않았으면 이 필드는 없습니다.
응답 (200 OK) — 완료
{
"status": 200,
"message": "규정 검수 결과 조회 완료",
"data": {
"trialId": "45de0ba5-91f3-4184-96ef-c87ac939fabc",
"policyKey": "metaAds",
"result": {
"status": "low",
"contentHash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
"summary": "건강웰니스 관련 위험이 확인되었습니다.",
"violations": [
{
"kind": "expression",
"text": "즉각적인",
"location": "필수 소구포인트",
"type": "건강웰니스",
"risk": "low",
"rule_id": "META_HEALTH_CLICKBAIT_TIMED_RESULT",
"reason": "...",
"fix": "...",
"source_url": "https://transparency.meta.com/policies/ad-standards/restricted-goods-services/health-wellness"
}
],
"requirements": [
{ "type": "disclosure_required", "status": "unknown", "reason": "..." }
],
"review_scope": {},
"corpus_version": "..."
}
}
}결과 본문(result)은 캠페인 가이드라인 규정 검수(GET /ai/admin/regulation/{collabNo}/guideline)의 result 와 같은 형식입니다.
존재하지 않는 trialId 면 400.