VOOR DE WEKELIJKSE SELECTIE

Een upload.
Een verse agenda.

Publiceer alle markten van deze kalenderweek met één beveiligde API-aanroep. Iedere geslaagde upload vervangt de volledige vorige selectie.

Authenticatie

Lezen is openbaar. Schrijven vereist de header Authorization: Bearer JOUW_TOKEN. Het gegenereerde token staat alleen in je lokale bestand .private/api-token.txt. Op de server wordt alleen een SHA-256-hash opgeslagen, buiten de publieke webmap. Zet het token uitsluitend in de geheime configuratie van je uploadtool.

Endpoints

Methode	Pad	Gedrag
GET	/api/markets.php	Huidige week, laatste upload, stale-status en markten.
PUT	/api/markets.php	Vervangt de volledige dataset. POST wordt als alternatief ondersteund.

Maximaal 200 markten en 1 MB per aanvraag. Alle records worden gecontroleerd vóór opslaan. Bij één fout wordt de hele upload geweigerd en blijft de vorige dataset behouden. Gelijktijdige uploads zijn geserialiseerd; de laatste succesvolle upload geldt. Upload alleen de complete selectie, nooit één tegel per aanvraag.

Uploadvoorbeeld

De data hieronder is een voorbeeld voor 19 t/m 25 oktober 2026. Gebruik altijd de huidige maandag voor week_start en pas alle evenementdatums aan de gecontroleerde kalenderweek aan.

{
  "week_start": "2026-10-19",
  "markets": [
    {
      "id": "werft-2026-10-25",
      "title": "Vlooienmarkt De Werft",
      "description": "Een overdekte markt met tweedehands spullen en curiosa.",
      "date": "2026-10-25",
      "start_time": "09:00",
      "end_time": "16:00",
      "location": "Sporthal De Werft",
      "address": "Huygenstraat 73, 5171 EP Kaatsheuvel",
      "city": "Kaatsheuvel",
      "latitude": 51.659,
      "longitude": 5.066,
      "url": "https://www.deevenementenlijn.nl/",
      "category": "Vlooienmarkt",
      "price": "€ 3",
      "image_url": "/assets/market-hall.webp",
      "image_is_illustrative": true
    }
  ]
}

export VK_API_TOKEN='vul-het-geheime-token-lokaal-in'
curl --fail-with-body --request PUT \
  'https://vlooienkrabber.itcleric.com/api/markets.php' \
  --header "Authorization: Bearer $VK_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data-binary @week.json

Succes: HTTP 200 met {"success":true,"replaced":true,"count":1,...}. Lees daarna GET terug en vergelijk de week, het aantal en de id's.

Velden & regels

Veld	Regel
week_start	Verplicht. De maandag van de huidige kalenderweek in YYYY-MM-DD.
markets	Verplichte lijst. Maximaal 200 objecten.
id	Uniek, max. 80 tekens, alleen a-z, 0-9 en koppeltekens.
title / description	Verplicht, max. 160 / 1600 bytes. Eigen Nederlandse beschrijving.
date	Verplicht, YYYY-MM-DD binnen de huidige kalenderweek.
start_time / end_time	HH:mm. Lege string of weglaten bij onbekend. Eindtijd na begintijd.
location / address / city	Verplicht. Naam locatie, volledig adres en plaats.
latitude / longitude	Verplichte getallen van de werkelijke locatie. De server berekent de afstand en weigert alles boven 40 km.
url	Verplichte HTTPS-link naar de marktbron.
category	Rommelmarkt, Vlooienmarkt, Brocante, Boekenmarkt, Kofferbakmarkt of Vintage. Standaard Rommelmarkt.
price	Bijvoorbeeld € 3, Gratis of Onbekend. Standaard Onbekend.
image_url	HTTPS-afbeelding of /assets/market-hall.webp, /assets/vintage-stall.webp, /assets/books.webp. Standaard market-hall.webp.
image_is_illustrative	Boolean, standaard true. Lokale beelden zijn altijd sfeerbeelden.
confirm_empty	Alleen verplicht bij markets: []. Zet true om bewust alles te wissen.

De grens van 40 km is hemelsbreed, geen rijafstand. Coördinaten moeten door de uploader bij een betrouwbare kaartbron worden gecontroleerd. De API kan niet vaststellen of een aangeleverde locatie inhoudelijk klopt. Datums van vorige weken worden automatisch verborgen; oude data wordt bij de volgende geldige upload vervangen. Em dashes en en dashes in invoerteksten worden naar een gewoon koppelteken omgezet.

Foutcodes

400: ongeldige JSON. 401: Bearer-token ontbreekt of klopt niet. 405: methode niet toegestaan. 413: meer dan 1 MB. 415: Content-Type is geen application/json. 422: ongeldige datum, afstand, velden, dubbele id of lege lijst zonder bevestiging. 500: opslagfout. 503: uploadconfiguratie ontbreekt.

ChatGPT koppelen

Configureer een tool die HTTPS PUT kan uitvoeren. Voor een eigen GPT kun je het OpenAPI-schema importeren als Action en authenticatie instellen op API Key, Bearer. Vul de ruwe tokenwaarde in als geheim.
Test eerst één volledige upload in dezelfde omgeving waarin de geplande taak zal draaien. Een leesbrowser kan deze API niet bijwerken. Een GPT Action is niet automatisch beschikbaar in elke geplande taak.
Plak de setup-prompt hieronder in de chat die je bestaande vlooienmarkten-taak beheert. De prompt laat de bestaande taak aanpassen en voorkomt een duplicaat.
Controleer na de eerste geplande run of de API echt is bijgewerkt. De website zelf bevat geen ingebouwde verzamelaar of zaterdagplanner; de gekoppelde ChatGPT-taak voert de verzameling en upload uit.

Gebaseerd op de officiële documentatie voor GPT Action-authenticatie en geplande taken. Beschikbare tools en uitvoeromgevingen hangen af van je account en configuratie.

Setup-prompt voor je bestaande taak

Pas mijn bestaande wekelijkse taak voor vlooienmarkten aan. Zoek eerst de bestaande taak en werk die bij; maak geen duplicaat. Behoud het bestaande tijdstip als dat op zaterdag valt, en gebruik anders zaterdag 08:00 Europe/Amsterdam.

Doel: verzamel iedere zaterdag alle vindbare en verifieerbare rommelmarkten, vlooienmarkten, brocante-, vintage-, kofferbak- en tweedehandsboekenmarkten binnen maximaal 40 km hemelsbreed van Tilburg centrum (51.5555, 5.0913). Publiceer de complete nieuwe selectie op https://vlooienkrabber.itcleric.com.

Lees vooraf https://vlooienkrabber.itcleric.com/api.html en het schema op https://vlooienkrabber.itcleric.com/openapi.json. Controleer dat de uitvoeromgeving echt HTTPS PUT-verzoeken kan doen via een geconfigureerde tool, Action, plugin of HTTP-client, met het geheime Bearer-token uit de beveiligde configuratie. Een alleen-lezen browser is onvoldoende. Zet het token nooit in de taakprompt, rapportage, publieke URL, schema of broncode. Als een vereiste koppeling ontbreekt, meld precies wat ontbreekt en claim geen upload.

Per uitvoering:
1. Bepaal de huidige kalenderweek, maandag t/m zondag, in Europe/Amsterdam. week_start is de maandag van de huidige week. Zoek expliciet op datum en jaar. Verzamel alle evenementen van die kalenderweek, ook als een dag al voorbij is. Gebruik geen rollende zeven dagen en geen volgende week.
2. Zoek breed op organisatoren, gemeentelijke agenda's, Meuk is Leuk, De Evenementenlijn, Vlooienmarktenkalender en lokale bronnen. Open de bronpagina's. Geef de voorkeur aan organisatoren. Verwijder dubbele vermeldingen van hetzelfde evenement op dezelfde dag. Zet iedere dag van een meerdaagse markt als aparte vermelding met unieke id en juiste dagtijden.
3. Controleer per evenement datum, adres, locatie en bronlink. Bepaal betrouwbare coördinaten van de werkelijke locatie via een kaart- of geocodeerbron, nooit zelf verzinnen. Sluit markten met onvoldoende verifieerbare locatie of datum uit. Bereken hemelsbrede afstand en sluit alles boven 40 km uit. Claim nooit dat de selectie gegarandeerd volledig is.
4. Vul per markt id, title, description (eigen korte Nederlandse tekst), date, start_time, end_time, location, address, city, latitude, longitude, url, category, price, image_url en image_is_illustrative in. Bij onbekende tijden gebruik je een lege string; bij onbekende entree 'Onbekend'. Gebruik een toegestaan category uit het schema. Geen em dashes in teksten.
5. Gebruik alleen een geschikte HTTPS-afbeelding met toegestaan gebruik. Anders een lokaal sfeerbeeld: /assets/market-hall.webp, /assets/vintage-stall.webp of /assets/books.webp, altijd image_is_illustrative: true. Claim bij sfeerbeelden niet dat het echte foto's van de markt zijn.
6. Stuur één compleet JSON-object met week_start en markets naar PUT https://vlooienkrabber.itcleric.com/api/markets.php met Content-Type: application/json en Authorization: Bearer <token uit beveiligde configuratie>. Deze actie vervangt ALLE oude gegevens. Stuur daarom nooit iedere markt apart. Upload alleen als het onderzoek volledig is afgerond. Bij een onderzoeks- of netwerkfout behoud je de bestaande data. Alleen als succesvol breed onderzoek echt nul markten oplevert, upload je markets: [] en confirm_empty: true.
7. Controleer HTTP 200, success: true, replaced: true en count. Haal vervolgens GET /api/markets.php op en vergelijk week_start, aantal en id's met de upload. Een 401 betekent onjuiste authenticatie; een 422 betekent dat de gehele upload is geweigerd en de oude dataset nog bestaat. Los de fout op en upload opnieuw alleen met gecontroleerde data.
8. Rapporteer kort het aantal gepubliceerde markten en de weekperiode, met de link naar de website. Meld onderzoeksbeperkingen of uploadfouten eerlijk. Meld alleen een geslaagde publicatie als de API en het teruglezen dit bevestigen.

Voer eerst één proefrun uit met de beschikbare tools en bevestig de werkende uploadkoppeling. Sla daarna deze werkwijze op in de bestaande zaterdagtaak. Als je vanuit deze chat geen toegang hebt tot die bestaande taak, geef dan de aangepaste taaktekst om daarin te plakken; maak geen nieuwe taak als vervanging zonder mijn opdracht.

Download als tekstbestand ↗

Token vernieuwen

Genereer een cryptografisch willekeurig token van minimaal 32 bytes. Vervang uitsluitend token_hash in het private config.php-bestand door de SHA-256-hash van het nieuwe token. Werk daarna het geheim in de uploadtool bij. Het oude token werkt direct niet meer. Het token staat nooit in de openbare website of dit schema.

Een upload.Een verse agenda.