API data agored
Rydyn ni'n cyhoeddi data byw am ein pwyntiau gwefru cyhoeddus o dan Reoliadau Pwyntiau Gwefru Cyhoeddus 2023, yn fformat OCPI 2.2.1. Mae mynediad am ddim. Cofrestrwch isod a byddwn yn anfon allwedd API atoch mewn e-bost ar unwaith.
Beth rydyn ni'n ei gyhoeddi
- Lleoliadau, EVSEs a chysylltwyr, gydag oriau agor a phŵer.
- Argaeledd byw. Mae newid statws yn ymddangos yn y ffrwd o fewn 30 eiliad.
- Tariffau, gan gynnwys y pris fesul kWh.
Defnyddio'r API
Dechreuwch yn y pwynt terfyn fersiynau:
https://plugcharging.co.uk/ocpi/versions
Anfonwch eich allwedd ym mhennawd Authorization pob cais. Mae cleientiaid OCPI sy'n anfon y tocyn wedi'i amgodio mewn base64 yn gweithio hefyd.
curl -H "Authorization: Token <your key>" https://plugcharging.co.uk/ocpi/versions
Gall pob allwedd wneud 120 cais y funud.
Trwydded a thelerau mynediad
Trwydded data agored
Mae'r data a gyhoeddir drwy'r API hwn ar gael o dan y Drwydded Llywodraeth Agored v3.0. Gallwch ei gopïo, ei gyhoeddi, ei ddosbarthu, ei addasu a'i ddefnyddio fel arall at unrhyw ddiben, gan gynnwys at ddibenion masnachol, ar yr amod eich bod yn cydnabod y ffynhonnell yn unol â'r drwydded.
Telerau mynediad yr API
Mae'r telerau hyn yn llywodraethu mynediad i'r API yn unig. Nid ydynt yn cyfyngu ar sut rydych yn defnyddio'r data.
- Rhoddir allweddi API yn rhad ac am ddim. Mae allwedd at ddefnydd yr unigolyn neu'r sefydliad cofrestredig a rhaid ei chadw'n gyfrinachol.
- Rhaid i bob cais gynnwys eich allwedd API ym mhennawd Authorization gan ddefnyddio'r cynllun Token.
- Ni ddylai ceisiadau fod yn fwy na'r terfyn cyfradd cyhoeddedig, sef 120 cais y funud fesul allwedd ar hyn o bryd. Caiff data argaeledd ei ddiweddaru o fewn 30 eiliad i newid statws.
- Rhaid i chi beidio â cheisio osgoi'r terfyn cyfradd, gan gynnwys drwy gofrestru sawl allwedd ar gyfer un gwasanaeth. Rhaid i chi beidio ag ymyrryd â gweithrediad yr API, na cheisio cael mynediad at unrhyw ran o'r gwasanaeth heblaw'r pwyntiau terfyn cyhoeddedig.
- Gall PLUG Charging atal neu ddirymu allwedd a ddefnyddir yn groes i'r telerau hyn. Lle bo'n ymarferol, byddwn yn rhoi gwybod i'r cyfeiriad hysbysu cofrestredig ymlaen llaw.
- Byddwn yn rhoi gwybod i'r cyfeiriad hysbysu cofrestredig am newidiadau sylweddol i'r API ac am waith cynnal a chadw wedi'i gynllunio.
- Darperir yr API ar sail ymdrechion rhesymol a gall newid yn unol â safon OCPI a Rheoliadau Pwyntiau Gwefru Cyhoeddus 2023.
- Gallwn ddiweddaru'r telerau hyn o bryd i'w gilydd. Byddwn yn rhoi o leiaf 30 diwrnod o rybudd am newidiadau sylweddol drwy e-bost i'r cyfeiriad hysbysu cofrestredig ac yn cyhoeddi'r telerau diwygiedig ar y dudalen hon gyda dyddiad fersiwn newydd. Mae parhau i ddefnyddio'r API ar ôl i newid ddod i rym yn golygu eich bod yn derbyn y telerau diwygiedig.
Eich manylion
Rydyn ni'n defnyddio eich enw a'ch cyfeiriadau e-bost i roi eich allwedd, anfon hysbysiadau gwasanaeth a chysylltu â chi am eich defnydd o'r API. Mae sefydliad a defnydd arfaethedig yn ddewisol ac yn ein helpu i ddeall sut mae'r data'n cael ei ddefnyddio. Gweler ein polisi preifatrwydd.
Fersiwn y telerau 2026-10-07
Cael allwedd API
Byddwn yn anfon yr allwedd atoch mewn e-bost. Os byddwch yn ei cholli, cofrestrwch eto gyda'r un cyfeiriad e-bost i gael un newydd yn ei lle.