Start page / Template development / FirstSpirit API / API documentation

API documentation

The API documentations ( Application Programming Interface) describe the public interfaces of FirstSpirit. These interfaces can be used in templates and scripts to access all kinds of different values, functions, etc.

Here, the Access-API and the Developer-API are differentiated. The difference results from different requirements concerning the stability. These will described in the following. For each API documentation another color is used (Access-API = blue, Developer-API = red).

Access API

The Access API is one of the most important interfaces of FirstSpirit. For this reason, it is subject to the highest stability requirements. These can be described as follows:

  • The Access API remains stable within a major version line.
  • The Access API is subject to the deprecation announcement:
    • Methods, classes and functions which are to be changed are marked as deprecated (@deprecated) in the current version line first.
    • If a deprecation is introduced with a minor version, it will remain in effect throughout individual releases of this minor version; thus, no code changes will be necessary to maintain compatibility with releases of this minor version.
    • Methods, classes and functions which are marked as deprecated in this way can be removed from the Access API or changed in the following major version.
  • When transitioning between minor or release versions, the use of released APIs does not require changes to the source code. In certain circumstances, transitioning between releases may require a module to be compiled against the target version. In this case, the respective module must be updated (see Modules (→Documentation for Administrators) and Update (→Documentation for Administrators)).

The FirstSpirit Access API documentation can be opened by clicking the following link:

Developer API

In contrast to the Access API, the requirements concerning the stability for the Developer API are lower:

  • The Developer API remains stable within a minor version line, i.e. methods, classes and functions may be changed in case of a minor version change.

The FirstSpirit Developer API documentation can be opened by clicking the following link:

Java SE Core API

The Java Standard Edition (SE) Core API documentation by Oracle (general functions) can be opened by clicking the following link:

JavaScript APIs

FirstSpirit provides several JavaScript APIs which allow functional linking of preview documents with the clients ContentCreator and SiteArchitect. For example, this enables updates of configuration parameters in “Multi Perspective Preview” (Multi Perspective Preview (→Documentation FirstSpirit SiteArchitect)) from within an HTML document in the integrated preview in order to synchronize these parameters with the current state of the document as navigation or other events occur.

ContentCreator

SiteArchitect

Multi Perspective Preview (both Clients)

© 2005 - 2022 Crownpeak Technology GmbH | All rights reserved. | FirstSpirit 2022.12 | Data privacy