API changes · API Change Guard
API retired in the knowledge snapshot — successor available
- Default severity
- Minor
- Finding code:
- API_SUCCESSOR_AVAILABLE
- Engine version:
- 2.2.0
What this finding means
API Change Guard reports this finding with the default severity “Minor”.
About the engine: OData, SOAP, RFC compatibility & deprecation impact scanner
How to fix it
Plan the migration of every registered consumer to the successor API named in the finding (knowledge snapshot) instead of adapting consumers to the retired API.
How ERP Preflight detects it
The analysis is deterministic: the same exported files and the same knowledge snapshot always produce the same findings. No SAP system connection is required — you upload exports.
- Engine
- API Change Guard
- Accepted formats
- JSON, XML, TEXT
- What to export
Two API specifications of the same service — baseline (current) and candidate (target release): OpenAPI 2/3 (JSON or YAML) or OData EDMX V2/V4 XML — supplied as {'baseline': …, 'candidate': …} in raw_content / configuration or as artifacts named *baseline* / *candidate*; optional 'integrations' registry for consumer impact.
- Required input
- baseline specification
- candidate specification
- Evidence
- Each finding points to the artifact path, line and column, the code snippet and the SHA-256 of the uploaded file. Findings without such a pointer are demoted to confidence UNKNOWN.
- Confidence
- Each finding names the knowledge it relies on (Knowledge-graph API lifecycle snapshot (configuration.api_lifecycle)) and is capped by that source’s verification status.
- Knowledge sources
- Knowledge-graph API lifecycle snapshot (configuration.api_lifecycle) — verified against the official source
- Target releases of the engine
- S4H_2022, S4H_2023, S4HANA_CLOUD_2402, S4HANA_CLOUD_2408
Related findings
- CriticalEndpoint removed
- CriticalOData entity type removed
- CriticalOData entity set removed
- CriticalProperty / field removed
- CriticalOData entity key changed
- CriticalOperation removed