{
  "api_name": "crm-erp-order-sync",
  "owner": "integration-team",
  "current_version": "v1",
  "compatibility_rules": [
    "Do not remove fields without a deprecation window.",
    "Do not change enum meaning without a migration guide.",
    "Additive nullable fields are backward compatible.",
    "Breaking changes require versioned endpoints or explicit consumer approval."
  ],
  "error_envelope": {
    "correlation_id": "string",
    "code": "string",
    "message": "string",
    "details": "object",
    "retryable": "boolean"
  },
  "deprecation_policy": {
    "notice_period_days": 90,
    "communication_channels": ["changelog", "email", "release_notes"],
    "required_migration_guide": true
  },
  "ci_checks": [
    "openapi-diff",
    "schema-validation",
    "consumer-contract-tests",
    "error-envelope-fixtures"
  ]
}