{"id":23869151,"url":"https://github.com/extrawest/extrawest-ocpi-2.2.1-emsp-client","last_synced_at":"2025-06-25T08:04:01.785Z","repository":{"id":180521688,"uuid":"663034295","full_name":"extrawest/Extrawest-OCPI-2.2.1-EMSP-Client","owner":"extrawest","description":"Client library for Open Charge-Point Protocol eMSP Server from extrawest.com","archived":false,"fork":false,"pushed_at":"2023-12-06T11:11:26.000Z","size":491,"stargazers_count":2,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-25T08:02:54.248Z","etag":null,"topics":["emsp","ocpi"],"latest_commit_sha":null,"homepage":"https://www.extrawest.com/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/extrawest.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-06T12:12:48.000Z","updated_at":"2024-10-07T09:55:17.000Z","dependencies_parsed_at":"2025-02-22T17:43:53.460Z","dependency_job_id":"72f3a6fe-5052-4411-8b15-751be7849cc4","html_url":"https://github.com/extrawest/Extrawest-OCPI-2.2.1-EMSP-Client","commit_stats":null,"previous_names":["extrawest/extrawest-ocpi-2.2.1-emsp-client"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/extrawest/Extrawest-OCPI-2.2.1-EMSP-Client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extrawest%2FExtrawest-OCPI-2.2.1-EMSP-Client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extrawest%2FExtrawest-OCPI-2.2.1-EMSP-Client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extrawest%2FExtrawest-OCPI-2.2.1-EMSP-Client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extrawest%2FExtrawest-OCPI-2.2.1-EMSP-Client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/extrawest","download_url":"https://codeload.github.com/extrawest/Extrawest-OCPI-2.2.1-EMSP-Client/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extrawest%2FExtrawest-OCPI-2.2.1-EMSP-Client/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261832616,"owners_count":23216494,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["emsp","ocpi"],"created_at":"2025-01-03T12:16:12.779Z","updated_at":"2025-06-25T08:04:01.729Z","avatar_url":"https://github.com/extrawest.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca href=\"https://www.extrawest.com/\"\u003e\u003cimg src=\"https://drive.google.com/uc?export=view\u0026id=1kXfNj5WfW2oSMzQR82xYBI6Bw_W8-LpK\" width=\"20%\"\u003e\u003c/a\u003e\n# Extrawest-OCPI-2.2.1-EMSP-Client\n\n## Badges\n\n![build](https://img.shields.io/github/actions/workflow/status/extrawest/Extrawest-OCPI-2.2.1-EMSP-Client/docker-image.yml?style=for-the-badge)\n![release](https://img.shields.io/github/v/release/extrawest/Extrawest-OCPI-2.2.1-EMSP-Client?style=for-the-badge)\n[![Java CI with Maven](https://github.com/extrawest/Extrawest-OCPI-2.2.1-EMSP-Client/actions/workflows/release-publish.yml/badge.svg)](https://github.com/extrawest/Extrawest-OCPI-2.2.1-EMSP-Client/actions/workflows/snapshot-publish.yml)\n![contr](https://img.shields.io/github/contributors/extrawest/Extrawest-OCPI-2.2.1-EMSP-Client?style=for-the-badge)\n![commits](https://img.shields.io/github/commit-activity/m/extrawest/Extrawest-OCPI-2.2.1-EMSP-Client?style=for-the-badge)\n![lastcommit](https://img.shields.io/github/last-commit/extrawest/Extrawest-OCPI-2.2.1-EMSP-Client?style=for-the-badge)\n![OCPI](https://img.shields.io/badge/OCPI-2.2.1-yellowgreen?style=for-the-badge)\n![JDK](https://img.shields.io/badge/JDK-17-yellow?style=for-the-badge)\n![social](https://img.shields.io/github/forks/extrawest/Extrawest-OCPI-2.2.1-EMSP-Client?style=for-the-badge)\n\n## Table of Contents\n\n- [Field of use](#field-of-use)\n- [Description](#description)\n- [Maven](#maven)\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Getting Started](#getting-started)\n- [Use in Spring Boot App](#using-extrawest-ocpi-221-emsp-client-in-spring-boot-application)\n- [API Endpoints](#api-endpoints)\n- [Models](#models) \n- [Authentication and Authorization](#authentication-and-authorization)\n- [Recommendation](#recommendation)\n- [License](#license)\n- [About Extrawest.com](#about-extrawestcom)\n\n## Field of use\nClient library for [OCPI eMSP Server](https://github.com/extrawest/Extrawest-OCPI-2.2.1-EMSP-Server). [Library for OCPI CPO](https://github.com/extrawest/Extrawest-OCPI-2.2.1-CPO-Client) can be found in other repo. Open Charge Point Interface (OCPI) is an open protocol used for connections between charging station operators and service providers. Simply put, this protocol facilitates automated roaming for EV drivers between different EV charging networks.\n\n*Automatically generated by the [OpenAPI Generator](https://openapi-generator.tech)* as a client library for [OCPI Server Library](https://github.com/extrawest/Extrawest-OCPI-2.2.1-EMSP-Server)\n\nDescription\n=============\n\nWith this library, you can easily get started with the Open Charge-Point Interface by making calls to OCPI EMSP Server API. It is a client to [OCPI eMSP Server](https://github.com/extrawest/Extrawest-OCPI-2.2.1-EMSP-Server), created using OpenAPI Generator\n\nPlease note, this is a library and not an application, so there is no main method. \n\nCurrently we support 2.2.1 OCPI version.\n\nMaven\n=====\n\nFind the maven repo here: https://mvnrepository.com/artifact/com.extrawest/Extrawest-OCPI-2.2.1-EMSP-Client\n\n## Requirements\n\nBuilding the API client library requires:\n\n1. Java 1.8+\n2. Maven\n\n## Installation\n\nTo install the API client library to your local Maven repository, simply execute:\n\n```shell\nmvn clean install\n```\n\n### Maven users\n\nAdd this dependency to your project's POM:\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.extrawest\u003c/groupId\u003e\n    \u003cartifactId\u003eExtrawest-OCPI-2.2.1-EMSP-Client\u003c/artifactId\u003e\n\u003c/dependency\u003e\n```\n\n### Others\n\nAt first generate the JAR by executing:\n\n```shell\nmvn clean package\n```\n\nThen manually install the following JARs:\n\n- `target/extrawest-ocpi-2.2.1-emsp-client-0.0.1.jar`\n- `target/lib/*.jar`\n\n## Getting Started\n\nPlease follow the [installation](#installation) instruction and execute the following Java code:\n\n```java\n\npublic class ClientInfoApiExample {\n\n    public static void main(String[] args) {\n        ApiClient defaultClient = Configuration.getDefaultApiClient();\n        defaultClient.setBasePath(\"http://localhost:8080\");\n\n        ClientInfoApi apiInstance = new ClientInfoApi(defaultClient);\n        String countryCode = \"countryCode_example\";\n        String partyId = \"partyId_example\";\n        try {\n            ClientInfoDto result = apiInstance.getHubClientInfo(countryCode, partyId);\n            System.out.println(result);\n        } catch (ApiException e) {\n            System.err.println(\"Exception when calling ClientInfoApi#getHubClientInfo\");\n            System.err.println(\"Status code: \" + e.getCode());\n            System.err.println(\"Reason: \" + e.getResponseBody());\n            System.err.println(\"Response headers: \" + e.getResponseHeaders());\n            e.printStackTrace();\n        }\n    }\n}\n\n```\n### Using Extrawest-OCPI-2.2.1-EMSP-Client in Spring Boot Application\n\n1. To access the EMSP API classes, we need to configure them as beans:\n```java\n@Configuration\npublic class EmspClientConfig {\n\n    @Bean\n    public EmspTariffControllerApi emspTariffApi() {\n        return new EmspTariffControllerApi(apiClient());\n    }\n\n    @Bean\n    public ApiClient apiClient() {\n        return new ApiClient();\n    }\n}\n```\n\n2. Since we configured our API classes as beans, we can freely inject them in our Spring-managed classes:\n```java\n\n@Service\npublic class EmspTariffServiceImpl implements  EmspTariffService {\n    @Autowired\n    private EmspTariffControllerApi emspTariffControllerApi;\n\n    @Override\n    public TariffDto getTariff() {\n        try {\n            return emspTariffControllerApi.getTariff(\"countryCode\", \"partyId\", \"tariffId\");\n        } catch (RestClientException e) {\n            throw new RuntimeException();\n        }\n    }\n}\n```\n\nSpring Boot application, where we have tested Extrawest-OCPI-2.2.1-EMSP-Client, has below Spring dependencies. In case of library and your project dependencies versions incompatibility, try to add next spring versions into you projects:\n```bash\n        \u003cdependency\u003e\n            \u003cgroupId\u003eorg.springframework\u003c/groupId\u003e\n            \u003cartifactId\u003espring-web\u003c/artifactId\u003e\n            \u003cversion\u003e5.3.24\u003c/version\u003e\n        \u003c/dependency\u003e\n        \u003cdependency\u003e\n            \u003cgroupId\u003eorg.springframework\u003c/groupId\u003e\n            \u003cartifactId\u003espring-context\u003c/artifactId\u003e\n            \u003cversion\u003e5.3.24\u003c/version\u003e\n        \u003c/dependency\u003e\n\n        \u003cdependency\u003e\n            \u003cgroupId\u003eorg.springframework\u003c/groupId\u003e\n            \u003cartifactId\u003espring-core\u003c/artifactId\u003e\n            \u003cversion\u003e5.3.24\u003c/version\u003e\n        \u003c/dependency\u003e\n```\n\n## API Endpoints\n\nAll URIs are relative to *http://localhost:8080*\n\n| Class                     | Method | HTTP request |\n|---------------------------| ------------- | ------------- |\n| *ClientInfoApi*           | [**getHubClientInfo**](docs/ClientInfoApi.md#getHubClientInfo) | **GET** /api/2.2.1/hubClientInfo/{country_code}/{party_id} |\n| *ClientInfoApi*           | [**putHubClientInfo**](docs/ClientInfoApi.md#putHubClientInfo) | **PUT** /api/2.2.1/hubClientInfo/{country_code}/{party_id} |\n| *EmspCdrApi*              | [**getCdr**](docs/EmspCdrApi.md#getCdr) | **GET** /emsp/api/2.2.1/cdr |\n| *EmspCdrApi*              | [**postCdr**](docs/EmspCdrApi.md#postCdr) | **POST** /emsp/api/2.2.1/cdr |\n| *EmspChargingProfilesApi* | [**postChargingProfile**](docs/EmspChargingProfilesApi.md#postChargingProfile) | **POST** /emsp/api/2.2.1/chargingProfiles |\n| *EmspChargingProfilesApi* | [**putChargingProfile**](docs/EmspChargingProfilesApi.md#putChargingProfile) | **PUT** /emsp/api/2.2.1/chargingProfiles/{session_id} |\n| *EmspCommandsApi*         | [**postCommand**](docs/EmspCommandsApi.md#postCommand) | **POST** /emsp/api/2.2.1/commands/{command}/{uid} |\n| *EmspCredentialsApi*      | [**deleteCredentials**](docs/EmspCredentialsApi.md#deleteCredentials) | **DELETE** /emsp/api/2.2.1/credentials |\n| *EmspCredentialsApi*      | [**getCredentials**](docs/EmspCredentialsApi.md#getCredentials) | **GET** /emsp/api/2.2.1/credentials |\n| *EmspCredentialsApi*      | [**postCredentials**](docs/EmspCredentialsApi.md#postCredentials) | **POST** /emsp/api/2.2.1/credentials |\n| *EmspCredentialsApi*      | [**putCredentials**](docs/EmspCredentialsApi.md#putCredentials) | **PUT** /emsp/api/2.2.1/credentials |\n| *EmspLocationApi*         | [**getConnector**](docs/EmspLocationApi.md#getConnector) | **GET** /emsp/api/2.2.1/locations/{country_code}/{party_id}/{location_id}/{evse_uid}/{connector_id} |\n| *EmspLocationApi*         | [**getEvse**](docs/EmspLocationApi.md#getEvse) | **GET** /emsp/api/2.2.1/locations/{country_code}/{party_id}/{location_id}/{evse_uid} |\n| *EmspLocationApi*         | [**getLocation**](docs/EmspLocationApi.md#getLocation) | **GET** /emsp/api/2.2.1/locations/{country_code}/{party_id}/{location_id} |\n| *EmspLocationApi*         | [**patchConnector**](docs/EmspLocationApi.md#patchConnector) | **PATCH** /emsp/api/2.2.1/locations/{country_code}/{party_id}/{location_id}/{evse_uid}/{connector_id} |\n| *EmspLocationApi*         | [**patchEvse**](docs/EmspLocationApi.md#patchEvse) | **PATCH** /emsp/api/2.2.1/locations/{country_code}/{party_id}/{location_id}/{evse_uid} |\n| *EmspLocationApi*         | [**patchLocation**](docs/EmspLocationApi.md#patchLocation) | **PATCH** /emsp/api/2.2.1/locations/{country_code}/{party_id}/{location_id} |\n| *EmspLocationApi*         | [**pushConnector**](docs/EmspLocationApi.md#pushConnector) | **PUT** /emsp/api/2.2.1/locations/{country_code}/{party_id}/{location_id}/{evse_uid}/{connector_id} |\n| *EmspLocationApi*         | [**pushEvse**](docs/EmspLocationApi.md#pushEvse) | **PUT** /emsp/api/2.2.1/locations/{country_code}/{party_id}/{location_id}/{evse_uid} |\n| *EmspLocationApi*         | [**pushLocation**](docs/EmspLocationApi.md#pushLocation) | **PUT** /emsp/api/2.2.1/locations/{country_code}/{party_id}/{location_id} |\n| *EmspSessionsApi*         | [**getSession**](docs/EmspSessionsApi.md#getSession) | **GET** /emsp/api/2.2.1/sessions |\n| *EmspSessionsApi*         | [**patchSession**](docs/EmspSessionsApi.md#patchSession) | **PATCH** /emsp/api/2.2.1/sessions |\n| *EmspSessionsApi*         | [**putSession**](docs/EmspSessionsApi.md#putSession) | **PUT** /emsp/api/2.2.1/sessions |\n| *EmspTariffApi*           | [**deleteTariff**](docs/EmspTariffApi.md#deleteTariff) | **DELETE** /emsp/api/2.2.1/tariffs |\n| *EmspTariffApi*           | [**getTariff**](docs/EmspTariffApi.md#getTariff) | **GET** /emsp/api/2.2.1/tariffs |\n| *EmspTariffApi*           | [**saveTariff**](docs/EmspTariffApi.md#saveTariff) | **PUT** /emsp/api/2.2.1/tariffs |\n| *EmspTokenApi*            | [**getTokens**](docs/EmspTokenApi.md#getTokens) | **GET** /emsp/api/2.2.1/tokens |\n| *EmspTokenApi*            | [**postToken**](docs/EmspTokenApi.md#postToken) | **POST** /emsp/api/2.2.1/tokens/{token_uid}/authorize |\n| *EmspVersionApi*          | [**getVersionDetails**](docs/EmspVersionApi.md#getVersionDetails) | **GET** /emsp/api/versions/details |\n|  *EmspVersionApi*         | [**getVersions**](docs/EmspVersionApi.md#getVersions) | **GET** /emsp/api/versions |\n\n## Models\n\n- [AbstractProfileResult](docs/AbstractProfileResult.md)\n- [ActiveChargingProfile](docs/ActiveChargingProfile.md)\n- [AdditionalGeoLocation](docs/AdditionalGeoLocation.md)\n- [AuthorizationInfoDto](docs/AuthorizationInfoDto.md)\n- [BusinessDetails](docs/BusinessDetails.md)\n- [CDRDto](docs/CDRDto.md)\n- [CdrDimension](docs/CdrDimension.md)\n- [CdrLocation](docs/CdrLocation.md)\n- [CdrToken](docs/CdrToken.md)\n- [ChargingPeriod](docs/ChargingPeriod.md)\n- [ChargingProfile](docs/ChargingProfile.md)\n- [ChargingProfilePeriod](docs/ChargingProfilePeriod.md)\n- [ClientInfoDto](docs/ClientInfoDto.md)\n- [CommandResult](docs/CommandResult.md)\n- [Connector](docs/Connector.md)\n- [CredentialsDto](docs/CredentialsDto.md)\n- [CredentialsRole](docs/CredentialsRole.md)\n- [DisplayText](docs/DisplayText.md)\n- [EVSE](docs/EVSE.md)\n- [Endpoint](docs/Endpoint.md)\n- [EnergyContract](docs/EnergyContract.md)\n- [EnergyMix](docs/EnergyMix.md)\n- [EnergySource](docs/EnergySource.md)\n- [EnvironmentalImpact](docs/EnvironmentalImpact.md)\n- [ExceptionalPeriod](docs/ExceptionalPeriod.md)\n- [GeoLocation](docs/GeoLocation.md)\n- [Hours](docs/Hours.md)\n- [Image](docs/Image.md)\n- [Location](docs/Location.md)\n- [LocationReferencesDto](docs/LocationReferencesDto.md)\n- [Price](docs/Price.md)\n- [PriceComponent](docs/PriceComponent.md)\n- [PublishTokenType](docs/PublishTokenType.md)\n- [RegularHours](docs/RegularHours.md)\n- [ResponseFormatAuthorizationInfoDto](docs/ResponseFormatAuthorizationInfoDto.md)\n- [ResponseFormatCDRDto](docs/ResponseFormatCDRDto.md)\n- [ResponseFormatCredentialsDto](docs/ResponseFormatCredentialsDto.md)\n- [ResponseFormatListTokenDto](docs/ResponseFormatListTokenDto.md)\n- [ResponseFormatListVersionDto](docs/ResponseFormatListVersionDto.md)\n- [ResponseFormatLocationData](docs/ResponseFormatLocationData.md)\n- [ResponseFormatObject](docs/ResponseFormatObject.md)\n- [ResponseFormatSessionDto](docs/ResponseFormatSessionDto.md)\n- [ResponseFormatString](docs/ResponseFormatString.md)\n- [ResponseFormatTariffDto](docs/ResponseFormatTariffDto.md)\n- [ResponseFormatVersionDetailsDto](docs/ResponseFormatVersionDetailsDto.md)\n- [SessionDto](docs/SessionDto.md)\n- [SignedData](docs/SignedData.md)\n- [SignedValue](docs/SignedValue.md)\n- [StatusSchedule](docs/StatusSchedule.md)\n- [TariffDto](docs/TariffDto.md)\n- [TariffElement](docs/TariffElement.md)\n- [TariffRestrictions](docs/TariffRestrictions.md)\n- [TokenDto](docs/TokenDto.md)\n- [VersionDetailsDto](docs/VersionDetailsDto.md)\n- [VersionDto](docs/VersionDto.md)\n\n## Authentication and Authorization\n\nAll endpoints do not require authorization or authentication.\n\n## Recommendation\n\nIt's recommended to create an instance of `ApiClient` per thread in a multithreaded environment to avoid any potential issues.\n\n## License\n\n\n[MIT License](LICENSE)\n\n## About Extrawest.com\n\n\nWe are devoted to push the marked for vehicles charging forward.\nThere are many standards out there, we intend to implement and share them. Any help is much appreciated!\n\nThe market is in its defining state, the practices and standards we come up with now, may very well stick around for decades to come.\n\nSee our vision at https://www.extrawest.com/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fextrawest%2Fextrawest-ocpi-2.2.1-emsp-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fextrawest%2Fextrawest-ocpi-2.2.1-emsp-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fextrawest%2Fextrawest-ocpi-2.2.1-emsp-client/lists"}