valid-postman-collection-syntax
Overview
This rule belongs to the postman-validation
ruleset and states that:
The provided Postman Collection file 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 Postman Collection file is not valid. |
Code | POSTMAN_V001 |
Type | Validation |
Rule System | Semantic |
Broad Category | Basic Structure |
Products Impacted | API Transformer, Code Generation, Developer Experience Portal |
Tags | postman api semantic validation collection syntax |
Suggested Fixes
- Try importing the file in the Postman app, export it and try again using that.
- Ensure that the file contents are complete.
- Ensure that the file uses valid JSON.
- Ensure that each element in the Postman Colletion file 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.
For More Information
- https://learning.postman.com/collection-format/getting-started/structure-of-a-collection/
- https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html
- https://schema.postman.com/collection/json/v2.1.0/draft-07/collection.json
- https://schema.postman.com/collection/json/v2.0.0/draft-07/docs/index.html
- https://schema.postman.com/collection/json/v2.0.0/draft-07/collection.json
- https://schema.postman.com/collection/json/v1.0.0/draft-07/docs/index.html
- https://schema.postman.com/collection/json/v1.0.0/draft-07/collection.json
- https://learning.postman.com/docs/introduction/overview/
- https://docs.apimatic.io/rulesets/overview/