OPTIMADE v1.2.0-rc.2

This is the final release candidate before v1.2.0; further changes are not expected to the the content of the specification at this point.

The full changelog can be found on GitHub at https://github.com/Materials-Consortia/OPTIMADE/v1.2.0-rc.2/develop/CHANGELOG.md, and an HTML build of the specification is available at https://optimade.org/specification.

OPTIMADE v1.2.0-rc.1

v1.2.0-rc.1 (December 2022)

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.

New features

• 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 corresponding files 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 and FALSE.
  Only strict equality (=) and inequality (!=) comparisons on individual fields are supported.
• Fuzzy comparisons on lists (#415)
  String comparisons like CONTAINS, STARTS WITH and ENDS WITH are now compatible with list filter operations like HAS, HAS ALL etc.
• Backoff time (#411):
• Database licenses (#414):
• Symmetry data (#405):

Full Changelog: v1.1.0...v1.2.0-rc.1

OPTIMADE v1.1.0

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.

New features

• The implementation field of the general meta response has been updated to include an issue_tracker field (#339).

Patches

• The mass field of the species attribute for the structures 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.

OPTIMADE v1.0.0

This is release v1.0.0 of the OPTIMADE API specification.

The specification has undergone a few changes since v1.0.0-rc.2, some not backward compatible.

A few highlighted changes directly affecting the API:

• Several changes related to version negotiation for future releases of the API have been added.

• The API may now be served on both the unversioned and versioned URLs.

• The top-level meta field has undergone major revision:

  • It is now mandatory, with a few mandatory subfields (e.g., api_version), and most other fields made optional.
  • A link to a schema may be provided.
  • It no longer contains an index_base_url, since this functionality is covered by root links in the /links endpoint.

• The unit field for describing properties in the /info endpoints is now standardized to use the Unified Code for Units of Measure.

OPTiMaDe API v1.0.0-rc.2

This is release candidate 2 of v1.0.0 of the OPTiMaDe API specification.

The specification has undergone a few large changes since the previous pre-release, some not backward compatible.

A few highlighted changes directly affecting the API:

• Our links object types served under /links have been re-specified to better fit how other resource objects are handled, and the links now also provide some guidance for clients that seek to aggregate results.
• A new structure property nperiodic has been introduced to allow queries on number of periodic dimensions.
• New ways have been created to specify atoms at unknown coordinates in structures as either "implicit" or attached to a site; the prior option to specify coordinates as null has been removed.
• The info endpoint for an entry type can now optionally specify type information for properties.
• Several minor specification bugs/inconsistencies have been fixed throughout the specification.

A few other highlighted changes:

• OPTIMADE is now written with all capital letters, instead of the previous invented mixed-case form.
• The schemas have been updated to reflect the latest changes and use updated text descriptions from the specification.
• The handling of index meta-databases has been clarified and improved, especially in relation to the centrally provided one.

Many thanks to all contributors!

OPTiMaDe API v1.0.0-rc.1

This is release candidate 1 of v1.0.0 of the OPTiMaDe API specification.

The specification has undergone major changes since the last release, many of them not backward compatible.

A few highlighted changes directly affecting the API:

• The filter language grammar has undergone several changes.
• When/how properties are to be included/excluded in responses has changed (some are always present, some by default, others only when requested.)
• Several minor specification bugs/inconsistencies have been fixed throughout the specification.

A few other highlighted changes:

• The license for the specification is now CC-BY 4.0.
• The source format is now reStructuredText (rst) rather than markdown, primarily to simplify toc, cross references, and section number handling.
• The makefile has a few additional helpful targets (see top of GNUmakefile for info).
• The registry of known OPTiMaDe providers is no longer part of the specification, it has been moved to a separate repository 'providers'.
• With this release, README.md now encourages implementing the latest released version rather than the development version.

OPTiMaDe API v0.10.0

This is the v0.10.0 release of OPTiMaDe.

The specification has undergone major changes, some of them backwards incompatible.

Some select important changes:

• Standardization of structural information (atom positions, etc.) in structures
• The filter language grammar have undergone large changes, with many new features added as optional.
• All info endpoints are now located under /info/...
• Support for links to other API base urls under /links/... used in particular to indicate subdatabases for the same provider.
• New entry type: bibliographic references.
• Possibility to indicate relationships between entries, e.g., to indicate references for a structure.

OPTiMaDe API v0.9.5

This is the initial public release of the OPTiMaDe API.