WZC Wapenveld · implementatievoorstel

Sportlink-data veilig ontsluiten via Cloudflare

Van Club.Dataservice naar snelle, beheersbare standen, programma’s en uitslagen op de clubsite.

SportlinkCloudflare WorkerWebsite
01 · Benodigdheden

De API begint bij Club.Dataservice

1

Module activeren

Bestel Club.Dataservice binnen Sportlink Club.

2

Client ID ophalen

Via Vereniging → Beheer → Gebruikersbeheer → Clubsite.

3

API testen

data.sportlink.com/teams met de Client ID.

De code P142957850 uit het Club-scherm is een competitie-/poule-identificatie, geen Client ID.

02 · Architectuur

Cloudflare vormt de gecontroleerde tussenlaag

BronSportlink APIteams · wedstrijden · standen
RegieWorkervalidatie · caching · fouten
GebruikClubsitesnelle JSON-responses
✓ Minder API-verkeer✓ Eén vast endpoint✓ Controle over toegestane calls
03 · Worker

Een kleine proxy is voldoende

export default {
  async fetch(request, env) {
    const url = new URL(request.url);
    const allowed = new Set(["teams", "wedstrijden", "stand"]);
    const article = url.pathname.slice(1);
    if (!allowed.has(article)) return new Response("Niet toegestaan", { status: 404 });

    const api = new URL(`https://data.sportlink.com/${article}`);
    api.search = url.search;
    api.searchParams.set("client_id", env.SPORTLINK_CLIENT_ID);
    return fetch(api, { cf: { cacheTtl: 300, cacheEverything: true } });
  }
};

Controleer de exacte artikelnamen en parameters in de Sportlink servicelijst voordat je publiceert.

04 · Beheer

Vier afspraken houden de koppeling betrouwbaar

Beperk endpoints

Sta alleen de benodigde Sportlink-artikelen toe.

Cache bewust

Bijvoorbeeld 5 minuten; korter rond wedstrijddagen.

Toon nette fouten

Laat de website bruikbaar blijven wanneer Sportlink tijdelijk niet reageert.

Meet gebruik

Controleer foutpercentages, responstijd en onverwachte pieken.

05 · Implementatie

Van activatie naar live data in vier stappen

  1. 01Activeer Club.Dataservice en verzamel de Client ID
  2. 02Valideer teams, competities, programma, uitslagen en stand
  3. 03Publiceer de Worker met variabelen en caching
  4. 04Koppel de clubsite en monitor de eerste wedstrijddagen
Besluit

Klaar om te koppelen zodra de Client ID beschikbaar is

Club.Dataservice actiefClient ID ontvangenCloudflare-project gekozen

Daarna kunnen we de echte endpoints testen en de stand van WZC Wapenveld publiceren.

Bronnen: Sportlink Club.Dataservice · Sportlink Support Center