Validator

The Validator checks an oJobPub document against the oJobPub JSON Schema (draft 2020-12), including the date, date-time and uri formats. It checks the schema only. It doesn't check that lastUpdated is current, that every url resolves, or the description policy that SourceTracker applies.

Web UI

Paste a document into the editor at validator.letsemploy.org and press Validate (or Ctrl/⌘ + Enter). Load example fills in a valid document, Format pretty-prints your input. Each violation is listed with its JSON path, e.g. $.jobs[0].url. JSON syntax errors show the line and column.

REST API

curl -s https://validator.letsemploy.org/api/v1/validate \
  -H 'Content-Type: application/json' \
  --data @ojobpub.json

{"valid": false, "errors": [{"message": "'title' is a required property", "path": "$.jobs[0]"}]}

The OpenAPI spec is at /api/v1/openapi.json.

Offline validation

Any JSON Schema draft 2020-12 validator works, e.g. in CI:

check-jsonschema \
  --schemafile https://raw.githubusercontent.com/letsemploy/schema/main/v1/ojobpub.json \
  public/.well-known/ojobpub.json

The schema validates structure only. Also make sure lastUpdated is current and every url resolves.

Self-hosting

docker run -d --name validator -p 8000:8000 ghcr.io/letsemploy/validator:main