valid-google-discovery-syntax
Overview
This rule belongs to the google-discovery-validation ruleset and states that:
The provided Google Discovery document must not contain any syntax/semantic issues and use only valid JSON. Each property in the file must have a type as defined in the standard.
| Property | Value |
|---|---|
| Enabled | Yes |
| Maximum Severity | Blocking |
| Message | Provided Google Discovery document is not valid. |
| Code | GOOGLEDISCOVERY_V001 |
| Type | Validation |
| Rule System | Semantic |
| Broad Category | Basic Structure |
| Products Impacted | API Transformer, Code Generation, Developer Experience Portal |
| Tags | google discovery api semantic validation syntax |
Suggested Fixes
- Ensure that the file uses valid JSON.
- Ensure that each element in the Google Discovery document has the expected type.
- Ensure that an array is not defined as an object or vice versa.
- Ensure that where a number is expected, a string value is not provided, etc.
- For objects, ensure that each property has a correct type assigned to it.