This is the first release candidate of v1.2.0 of the OPTIMADE API specification. It should contain all of the new features in the specification, but their implementation may be modified in the final release.
Note: The OpenAPI schemas distributed in ./schemas
have not yet been modified with the new features 1.2.0.
This minor release adds significant but optional new functionality to the specification, as well as providing several clarifications to existing behaviour.
- Property definitions (#376). A new section titled Property Definitions has been added to the specification which significantly extends the way in which implementations can define and describe the custom properties they serve, including URIs, unit definitions, API support levels (for querying and sorting) as well as full support for JSON Schema constructs for describing the JSON representation of the property.
- Files endpoint (#360).
The
/files
endpoint and correspondingfiles
entry type has been added to provide a robust way of linking entries to arbitrary file-based data relevant to the entry, such as alternative crystal structure representation formats, input or output files from computational procedures, or experimental data files. - Boolean values (#348).
Boolean values were overlooked in the first version of the filter grammar as no OPTIMADE fields required them.
This functionality has been introduced for boolean fields using the syntax
TRUE
andFALSE
. Only strict equality (=
) and inequality (!=
) comparisons on individual fields are supported. - Fuzzy comparisons on lists (#415)
String comparisons like
CONTAINS
,STARTS WITH
andENDS WITH
are now compatible with list filter operations likeHAS
,HAS ALL
etc. - Backoff time (#411):
- Database licenses (#414):
- Symmetry data (#405):
This is release v1.1.0 of the OPTIMADE API specification.
This is a minor release that primarily patches minor specification errors and introduces one new feature.
- The
implementation
field of the generalmeta
response has been updated to include anissue_tracker
field (#339).
- The
mass
field of thespecies
attribute for thestructures
entry type has been updated from a float to a list of floats (#344).- This was deemed a specification bug that now is fixed in both the specification text and the schemas.
- Note: this could constitute a breaking change for software implemented to strictly adhere to the v1.0.0 specification.
- The specification text has been clarified in several places without change of intended meaning.
- Multiple typos, grammatical errors, and incorrect API examples have been fixed.
- The OpenAPI schemas are now fully compliant with the Swagger validator.
This is release v1.0.1 of the OPTIMADE API specification.
This release contains all of the patches from v1.1.0, whilst maintaining compatibility with v1.0.0.
This is release v1.0.0 of the OPTIMADE API specification.