https://github.com/OpenChargingCloud/OCPIExplorerWebApp
An OCPI Explorer as a Web App
https://github.com/OpenChargingCloud/OCPIExplorerWebApp
e-mobility evcharging evroaming ocpi openapi opendata
Last synced: about 1 month ago
JSON representation
An OCPI Explorer as a Web App
- Host: GitHub
- URL: https://github.com/OpenChargingCloud/OCPIExplorerWebApp
- Owner: OpenChargingCloud
- License: agpl-3.0
- Created: 2024-12-08T03:44:22.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2025-08-22T03:43:05.000Z (about 2 months ago)
- Last Synced: 2025-08-29T07:10:02.071Z (about 1 month ago)
- Topics: e-mobility, evcharging, evroaming, ocpi, openapi, opendata
- Language: TypeScript
- Homepage:
- Size: 1.17 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ev-charging - OpenChargingCloud/OCPIExplorerWebApp
README
# OCPI Explorer WebApp
This project implements the [**Open Charge Point Interface (OCPI)**](https://github.com/ocpi/ocpi) defined by the [EV Roaming Foundation](https://evroaming.org) as a web application using web technologies like Java-/TypeScript, HTML, and (S)CSS. The focus of this project is **testing** and **certification** of the OCPI protocol and 3rd party vendor extensions. This project supports the following protocol versions and extensions:
- [OCPI v2.1.1](https://github.com/ocpi/ocpi/tree/release-2.1.1-bugfixes) *(under development)*
- [OCPI v2.2.1](https://github.com/ocpi/ocpi/tree/release-2.2.1-bugfixes) *(under development)*
- [OCPI v2.3.0-rc2](https://github.com/ocpi/ocpi/tree/develop-2.3.0) *(under development)*
- [OCPI v3.0](https://github.com/ocpi/ocpi/tree/develop-3.0) *(experimental... there be dragons!)*
## Installation
With a recent Node.js installation, you can simply clone the repository, install the JavaScript dependencies, compile the code, and then run the webpack development server.
```
git clone https://github.com/OpenChargingCloud/OCPIExplorerWebApp.git
cd OCPIExplorerWebApp
npm install
npm run build
npm start
```
Your prefered web browser should automagically open http://localhost:1608
## Usage
The web app understands the following HTTP query parameters:
http://localhost:1608?url=https://api.example.org/ocpi2.1/versions&token=2435&nobase64
| Parameter | Example Value | Description |
|-----------|------------------------------------------|-----------------------------------------------------------------------|
| url | https://api.example.org/ocpi2.1/versions | The OCPI versions URL. |
| token | abcd | The OCPI access token. |
| nobase64 | | The OCPI access token will not be base64 encoded before transmission. |
**Note**: For basic usage scenarios, URL encoding these HTTP query parameters is not mandatory.
However, if the `url` or `token` parameter contains special characters, make sure to URL encode them.
## License
[GNU Affero General Public License)](LICENSE)