Create a preview request
POST
/v1/quality-rule-sets/{ruleSetId}/preview-requestscurl -X POST 'https://api.embodiflow.io/v1/quality-rule-sets/{ruleSetId}/preview-requests' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT' \
-H 'Content-Type: application/json' \
-d '{
"datasetVersionId": "00000000-0000-0000-0000-000000000000",
"ruleSetDraft": {}
}'认证
每个请求都需要携带个人访问令牌（PAT）。
- Authorization: Bearer PAT
路径参数
- ruleSetIdstring必填
请求头参数
- Idempotency-Keystring
Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.
请求体
Content-Typeapplication/json
- datasetVersionIdstring (uuid)必填
- ruleSetDraftobject
响应
Success
- dataobject必填
- qualityRuleSetIdstring必填
- projectIdstring必填
- datasetVersionIdstring必填
- usedDraftone of必填
- summaryobject必填
- findingsarray<QualityRuleSetPreviewFindingDto>必填
- diagnosticsarray<QualityRuleSetPreviewDiagnosticDto>必填
- versionFindingsarray<object>必填
- policySnapshotHashstring
- metricsDocumentSourcestring | null
- draftPolicyErrorstring | null
- checksarray<QualityRuleSetPreviewCheckDto>
响应示例
{
"data": {
"qualityRuleSetId": "string",
"projectId": "string",
"datasetVersionId": "string",
"usedDraft": false,
"summary": {
"overallStatus": "failed",
"passedCount": 0,
"warningCount": 0,
"failedCount": 0,
"fileCount": 0,
"visibilityStatus": "active",
"notEvaluatedCount": 0
},
"findings": [
{
"datasetVersionFileId": "string",
"logicalPath": "string",
"qualityStatus": "failed",
"details": [
{}
]
}
],
"diagnostics": [
{
"severity": "warning",
"code": "string",
"message": "string",
"details": {}
}
],
"versionFindings": [
{}
],
"policySnapshotHash": "string",
"metricsDocumentSource": "string",
"draftPolicyError": "string",
"checks": [
{
"checkId": "string",
"bindingIdentity": "string",
"ruleVersion": 0,
"family": "string",
"enabled": false,
"severity": "string",
"blocking": false,
"verdict": "warn",
"nonVerdictReason": "string",
"status": "string",
"message": "string",
"findingCount": 0,
"previewSupported": false
}
]
}
}服务器https://api.embodiflow.io/v1https://api.embodiflow.dev/v1