version_information_endpoint.md

Version information endpoint

This endpoint lists all the available OCPI versions and the corresponding URLs to where version specific details such as the supported endpoints can be found.

Example endpoint structure: /ocpi/cpo/versions and /ocpi/emsp/versions The exact URL to the implemented version endpoint should be given (offline) to parties that interface with your OCPI implementation, this endpoint is the starting point for discovering locations of the different modules and version of OCPI that have been implemented.

Both the CPO and the eMSP must have this endpoint.

| Method | Description | | -------- | ----------------------------------------------------------------------- | | GET | Fetch information about the supported versions. |

Data

| Property | Type | Card. | Description | |-----------|----------------------------|--------|-------------------------------------------| | versions | [Version](#version-class) | + | A list of supported OCPI versions. |

Version class

| Property | Type | Card. | Description | |----------|--------------------------------------|-------|-------------------------------------------| | version | [VersionNumber](#versionnumber-enum) | 1 | The version number. | | url | [URL](types.md#16-url-type) | 1 | URL to the endpoint containing version specific information. |

GET

Fetch all supported OCPI versions of this CPO or eMSP.

Example

[
    {
        "version": "1.9",
        "url": "https://example.com/ocpi/cpo/1.9/"
    },
    {
        "version": "2.0",
        "url": "https://example.com/ocpi/cpo/2.0/"
    }
]

Version details endpoint

Example: /ocpi/cpo/2.0/ and /ocpi/emsp/2.0/

This endpoint lists the supported endpoints and their URLs for a specific OCPI version. To notify the other party that the list of endpoints of your current version has changed, you can send a PUT request to the corresponding credentials endpoint (see the credentials chapter).

Both the CPO and the eMSP must have this endpoint.

| Method | Description | | -------- | ----------------------------------------------------------------------- | | GET | Fetch information about the supported endpoints for this version. |

Data

| Property | Type | Card. | Description | |------------|---------------------------------------|--------|--------------------------------------------------| | version | [VersionNumber](#versionnumber-enum) | 1 | The version number. | | endpoints | [Endpoint](#endpoint-class) | + | A list of supported endpoints for this version. |

Endpoint class

| Property | Type | Card. | Description | |-------------|------------------------------|--------|-------------------------------------------| | identifier | [ModuleID](#moduleid-enum) | 1 | Endpoint identifier. | | url | [URL](types.md#16-url-type) | 1 | URL to the endpoint. |

ModuleID enum

The Module identifiers for each endpoint are in the beginning of each Module chapter. The following table contains the list of modules in this version of OCPI. Most modules (except Credentials & registration) are optional, but there might be dependencies between modules, if so that will be mentioned in the module description.

| Module | ModuleID | Remark | |-------------------------------------------------------------------|---------------|------------------------------------------------------------------| | [CDRs](mod_cdrs.md#cdrs-module) | cdrs |   | | [Commands](mod_commands.md#commands-module) | commands |   | | [Credentials & registration](credentials.md#credentials-endpoint) | credentials | Required for all implementations | | [Locations](mod_locations.md#locations-module) | locations |   | | [Sessions](mod_sessions.md#sessions-module) | sessions |   | | [Tariffs](mod_tariffs.md#tariffs-module) | tariffs |   | | [Tokens](mod_tokens.md#tokens-module) | tokens |   |

 

 

 

VersionNumber enum

List of known versions.

| Value | Description | |----------|-------------------------------------| | 2.0 | OCPI version 2.0. | | 2.1 | OCPI version 2.1. (this version) |

Custom Modules

Parties are allowed to create custom modules or customized version of the existing modules. For this the ModuleID enum can be extended with additional custom moduleIDs. These custom moduleIDs MAY only be send to parties with which there is an agreement to use a custom module. Do NOT send custom moduleIDs to parties you are not 100% sure that they understand the custom moduleIDs. It is advised to use a prefix (country_code + party_id) for any custom moduleID, this ensures that the moduleID will not be used for any future module of OCPI.

For example: nltnm-tokens

GET

Fetch information about the supported endpoints and their URLs for this version.

Example

{
    "version": "2.0",
    "endpoints": [
        {
            "identifier": "credentials",
            "url": "https://example.com/ocpi/cpo/2.0/credentials/"
        },
        {
            "identifier": "locations",
            "url": "https://example.com/ocpi/cpo/2.0/locations/"
        }
    ]
}