Comment

1{
2  "schemaVersion": 1,
3  "domain": "blog",
4  "entity": "comment",
5  "displayName": "Blog Comment",
6  "target": {
7    "classification": "native-plus-cms",
8    "nativeEntity": "Comment",
9    "verifiedFqdn": null,
10    "idPolicy": "server-assigned",
11    "crosswalkRequired": true
12  },
13  "sourceAliases": [
14    { "sourceSystem": "wordpress", "sourceEntity": "comment", "routes": ["/wp/v2/comments"], "confidence": "high" },
15    { "sourceSystem": "wix", "sourceEntity": "comment", "routes": ["Comments API"], "confidence": "medium" }
16  ],
17  "preferredWrite": {
18    "surface": "Comments",
19    "endpoint": "POST /comments/v1/comments",
20    "writerId": null,
21    "verification": "docs",
22    "importSafe": false,
23    "bulk": false
24  },
25  "fallbacks": [
26    { "classification": "cms", "when": "Use for unsupported target relations, moderation history, IP/user-agent policy limits, or threading gaps." }
27  ],
28  "reliability": { "status": "partially-reliable", "flags": [] },
29  "pitfalls": [
30    { "code": "relation-required", "severity": "blocker", "summary": "Verify the target relation and notification behavior before native comment writes." }
31  ],
32  "mappingGuidance": ["Classify blog comments, page comments, product reviews, and custom-post comments separately."],
33  "setupRequirements": ["Comment relation verification before execution."],
34  "evidence": [
35    { "type": "repo-research", "path": "research/import-api-suitability/blog-cms-media.md" }
36  ]
37}