This repository contains the source code used to publish Pucora's configuration schema. The official Pucora schema lives under https://pucora.in/schema/pucora.json for the latest version, and https://pucora.in/schema/vX.x/pucora.json for a specific version (replace vX.x by the version, e.g., v2.3)
If you are looking to validate your endpoints' JSON schema, see JSON-schema validation.
You must use Pucora v2.0 and higher.
Pucora uses this schema automatically during the pucora check --lint command, but we advise you to use it in your IDE to assist you during development. Some of the features IDEs offer while working with JSON-schema is:
- Automatic validation as you type
- Show documentation of attributes
- Linting and syntax errors
- Warning for wrong types
- Autocompletion of properties
In most modern editors, there is nothing you need to install as they have built-in json schema validation. Visual Studio Code, Android Studio, JetBrains editors (PHPStorm, PyCharm, GoLand, WebStorm, IntelliJ IDEA...), or Eclipse, to name a few examples.
To use this schema add the $schema attribute in your configuration files. There is no need to clone this repo unless you'd like to submit a pull request:
{
"$schema": "https://pucora.in/schema/v2.3/pucora.json",
"version": 3,
"endpoints": [
...
]
}
Replace the v2.3 in the URL by the Pucora version you are using.
You can also use sub-schemas if needed. The pucora.json file is the main schema that references other sub-schemas with the $ref attribute.
For more information visit IDE integration
If you find any inconsistency in the schema, please open an issue or pull request.