API Output

Je kan de endpoints aanroepen via GET

Je kan de variabelen via de URL meegeven dus ?token of ?periode=3&token=XXXXXX

Maar je kan ook de variabelen meegeven in de GET body

{’token’:’xxxxxxxx’, ‘periode’: 3}

De SUPPLIER_SHORT_NAME is vast in de URL.

Endpoint Leveranciers

http://www.energieadvieszeeland.nl/wp-json/prices/v1/supplier/{SUPPLIER_SHORT_NAME}?token={TOKEN}

SUPPLIER_SHORT_NAME = Leverancier korte naam
TOKEN = API Sleutel / Token

Voorbeeld return:

{
    "status": 200,
    "message": "OK",
    "data": {
        "supplier": {
            "name": "ANWB energie",
            "short_name": "ANWB",
            "vastrecht_stroom": "5.79",
            "opslag_stroom": "0.04",
            "vastrecht_gas": "5.79",
            "opslag_gas": "0.05"
        }
    }
}

Endpoint Stroom prijzen

http://www.energieadvieszeeland.nl/wp-json/prices/v1/electricity/{SUPPLIER_SHORT_NAME}?token={TOKEN}

SUPPLIER_SHORT_NAME = Leverancier korte naam
TOKEN = API Sleutel / Token

De stroomprijzen voor morgen krijg je automatisch mee zodra ze beschikbaar zijn. Meestal rond 14:00.

Endpoint Gas prijzen

http://www.energieadvieszeeland.nl/wp-json/prices/v1/gas/{SUPPLIER_SHORT_NAME}?token={TOKEN}

SUPPLIER_SHORT_NAME = Leverancier korte naam
TOKEN = API Sleutel / Token

Endpoint Stroom prijzen goedkoopste periode

De periode tussen twee tijdstippen waar gemiddeld de prijs het meest voordelige is vandaag of morgen.

http://www.energieadvieszeeland.nl/wp-json/prices/v1/electricity/{SUPPLIER_SHORT_NAME}/cheapest/?period={AANTAL_UUR}&from={FROM}&till={TILL}&tomorrow={TOMORROW}&token={TOKEN}

SUPPLIER_SHORT_NAME = Leverancier korte naam
AANTAL_UUR = aantal uren dat jouw periode moet zijn
FROM = van tijd, numeriek of leeg
TILL = tot tijd, numeriek of leeg
TOMORROW = Boolean (0/1) of leeg
TOKEN = API Sleutel / Token

Voorbeeld return:

{
    "tomorrow": 1,
    "period": 4,
    "date": "2024-02-03",
    "from": 1,
    "till": 23,
    "start_hour": "02",
    "end_hour": "05",
    "average_price": 0.24688839999999998,
    "prices": {
        "02": 0.25022799999999995,
        "03": 0.2462229,
        "04": 0.2443474,
        "05": 0.24675529999999998
    }
}

Endpoint Stroom prijzen goedkoopste komende periode

De komende periode waar gemiddeld de prijs het meest voordelige is vandaag of morgen. Dus bijvoorbeeld, toon me de goedkoopste periode binnen nu en 10 uur.

http://www.energieadvieszeeland.nl/wp-json/prices/v1/electricity/{SUPPLIER_SHORT_NAME}/lookahead_period/?period={PERIOD}&lookahead={LOOKAHEAD}&token={TOKEN}

SUPPLIER_SHORT_NAME = Leverancier korte naam
TOKEN = API Sleutel / Token
PERIOD = INT, aantal goedkoopste uren dat je nodig hebt
LOOKAHEAD = INT, periode dat hij vooruit moet kijken. Kan tot 34 uur in toekomst mits het 14u is geweest!!

Voorbeeld return:

{
    "start_date": "2024-02-03",
    "start_time": "03",
    "end_date": "2024-02-03",
    "end_time": "06",
    "average_price": 0.19603815,
    "prices": {
        "2024-02-03": {
            "03": 0.196988,
            "04": 0.19333379999999997,
            "05": 0.19384200000000001,
            "06": 0.19998879999999997
        }
    }
}