OpenAPI representation of the ISCC data model
Project description
ISCC - Schema
OpenAPI representation of the ISCC data model
Introduction
This repository hosts all schema definitions of the ISCC. Schemas are defined in OpenAPI v3.1.0 format and serve as a single source of truth for auto-generated JSON Schema definitions, JSON-LD contexts, and other schema related artifacts.
Documentation
Documentation is hosted at schema.iscc.codes
Status
Under development. Expect breaking changes until we reach a version 1.0 release.
Generated files
The source of code generation are the files at iscc_schema/models/*
.
The outputs produced when running poe build
are:
docs/schema/iscc.json
- JSON Schema for ISCC Metadatadocs/schema/index.md
- JSON Schema Markdown documentationdocs/context/iscc.jsonld
- JSON-LD context for ISCC Metadatadocs/terms/index.md
- ISCC Metadata Vocabulary documentationiscc_schema/schema.py
- Pydantic models for ISCC Metadataiscc_schema/generator.py
- Pydantic models for Generator Service API
Published files
The generated files are published under the following canonical URLs:
http://purl.org/iscc/schema
- JSON Schema latest versionhttp://purl.org/iscc/context
- JSON-LD Context latest versionhttp://purl.org/iscc/terms
- ISCC Metadata Vocabulary latest versionhttp://pypi.org/project/iscc-schema
- Python package with pydantic models
OpenAPI Docs
OpenAPI Extensions
The OpenAPI Specification allows for
extending the
specification with custom fields. Extensions must start with x-
.
All ISCC extensions start with x-iscc-
:
x-iscc-context
- for documenting JSON-LD contexts.x-iscc-schema-doc
- for original descriptions from schema.org.x-iscc-embed
- for information on how to embed fields into media assets.
Changelog
0.3.0 - 2022-02-10
- Added draft API for ISCC Generator Service
- Added new collection schema
- Updated dependencies
- Added new terms: verify, original, redirect
0.2.1 - 2022-01-19
- Tweak code generator
- Cleanup dependencies
0.2.0 - 2022-01-17
- Added generator field
- Changed properties field to support base64
- Changed iscc validation to support Semantic-Code
0.1.0 - 2022-01-05
- Initial release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for iscc_schema-0.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d76144d2f8a16b4a475871ca167d4a83eac44b421ee1ba6bc7dfc9ce1dc621db |
|
MD5 | 5bb43b63a6b7c71ccd1bba32f120e5fd |
|
BLAKE2b-256 | 945f403e2bb02f72564b5437d028c38c37e46642dabdf2b1031e2f1dafb4b6e6 |