Aanbod aanleveren

Alle partijen — particulieren, gemeenten, instanties, corporaties en IT-partners — kunnen woningen toevoegen aan de open database van DoorstroomNet. Kies uw situatie en het kanaal dat het beste past.

Wie bent u?

Stap 1 — kies uw organisatietype

Aanbevolen: Website

Als particulier meldt u één of enkele woningen aan via het webformulier. Na beoordeling door de gemeente komt uw woning in het aanbod.

• Geen technische kennis nodig — vul het formulier in op uw telefoon of laptop.
• Houd uw e-mailadres bij de hand voor bevestiging en vragen van de gemeente.

Direct starten

Stap 2

Kies een aanleverkanaal

Alle kanalen schrijven naar dezelfde database. Webformulier en API zijn het meest gebruikt; CLI en MCP zijn bedoeld voor automatisering en AI-koppelingen.

Website — Webformulier — de makkelijkste route

Huidige stap

Open het aanmeldformulier, vul adres en kenmerken in en dien in. Geschikt voor particulieren en kleine organisaties zonder IT-koppeling.

Geen account of API-sleutel nodig.
Inzending krijgt status in_beoordeling tot de gemeente goedkeurt.

Geschikt voor: Particuliere verhuurder, Maatschappelijke instantie, Gemeente / overheid

Naar formulier

REST API — Open API — voor systemen en koppelingen

Stuur woninggegevens als JSON naar POST /api/v1/aanbod met een Bearer-token. Lees status terug met GET. Ideaal voor gemeentelijke applicaties en corporatie-ERP.

API-sleutels beheren via /aanbod/aanleveren/sleutels (ingelogd als corporatie/gemeente).
Demo-sleutel: dsn_demo_gemeente_leiden (zie README).

Geschikt voor: Gemeente / overheid, Woningcorporatie, IT-partner / platform, Maatschappelijke instantie

curl -X POST http://localhost:3000/api/v1/aanbod \
  -H "Authorization: Bearer dsn_JOUW_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{
    "indienerNaam": "Gemeente Leiden",
    "indienerEmail": "vastgoed@gemeente-leiden.nl",
    "indienerType": "gemeente",
    "adres": "Stationsweg 12",
    "plaats": "Leiden",
    "kamers": 3,
    "m2": 75,
    "huurMaand": 720,
    "externReferentie": "VLG-2026-0042"
  }'

Meer uitleg

Commandoregel (CLI) — CLI — scripts en bulk-import

Het hulpprogramma dsn-aanlever verstuurt JSON-bestanden of enkele woningen vanaf de terminal. Handig voor eenmalige migraties of cronjobs.

Stel DSN_API_KEY en optioneel DSN_BASE_URL in.
Ondersteunt submit, status en list.

Geschikt voor: IT-partner / platform, Gemeente / overheid, Woningcorporatie

export DSN_API_KEY=dsn_JOUW_SLEUTEL
npx tsx scripts/dsn-aanlever.ts submit --file woning.json
npx tsx scripts/dsn-aanlever.ts status <inzending-id>
npx tsx scripts/dsn-aanlever.ts list

Meer uitleg

MCP-server (AI) — MCP — AI-assistenten koppelen

De Model Context Protocol-server geeft tools aan Cursor, Claude Desktop of andere MCP-clients: woning_indienen, inzending_status en inzendingen_lijst.

Configureer in .cursor/mcp.json of claude_desktop_config.json.
De server praat met dezelfde REST API — één open database.

Geschikt voor: IT-partner / platform, Gemeente / overheid

{
  "mcpServers": {
    "doorstroomnet": {
      "command": "npx",
      "args": ["tsx", "mcp-server/index.ts"],
      "env": {
        "DSN_API_KEY": "dsn_JOUW_SLEUTEL",
        "DSN_BASE_URL": "http://localhost:3000"
      }
    }
  }
}

Meer uitleg

Open database

Eén centrale opslag — meerdere ingangen

In deze demonstratie staat alle data in data/doorstroomnet.db. Inzendingen komen in woning_inzendingen; na goedkeuring in woningen. Extern Zig365-aanbod wordt gesynchroniseerd naar cached_listings. API-sleutels en aanleveraccounts worden beheerd in aanlever_accounts en api_keys.

API-sleutels beherenVoor ingelogde corporatie, gemeente of beheer Gemeente beoordelingInzendingen goedkeuren of afwijzen