blueprint/API Documentatie

v1.0 — StabielDashboard

REST API

API Documentatie

De Blueprint REST API geeft u programmatische toegang tot alle modules van uw platform. Gebruik de API voor eigen integraties, webhooks of automatiseringen. (The Blueprint REST API gives programmatic access to all platform modules — for custom integrations, webhooks and automations.)

Authenticatie / Authentication

Sessie-cookie (aanbevolen voor browsers)

Gebruik POST /api/auth/login om een sessie te starten. Het antwoord bevat een httpOnly cookie bp_session dat automatisch bij elk volgend verzoek wordt meegestuurd door de browser.

POST /api/auth/login
Content-Type: application/json

{ "email": "jan@bedrijf.nl", "password": "..." }

# Alle volgende requests kunnen het cookie automatisch gebruiken
GET /api/dashboard/data?table=crm_contacts

API-sleutel (voor server-to-server)

Voeg een Authorization header toe aan elke request. API-sleutels zijn beschikbaar via Dashboard → Instellingen → Koppelingen.

GET /api/dashboard/data?table=crm_contacts
Authorization: Bearer bp_live_xxxxxxxxxxxxxxxxxxxx

Basis-URL / Base URL

https://blueprint-solutions.nl

Limieten / Rate Limits

Plan	Limiet	Opmerking
Starter	60 verzoeken per minuut	Geldt per org_id
Professional	200 verzoeken per minuut	Geldt per org_id
Enterprise	600 verzoeken per minuut	Geldt per org_id, aanpasbaar op verzoek

Bij overschrijding ontvangt u HTTP 429 Too Many Requests. De header Retry-After geeft aan wanneer u opnieuw kunt proberen.

Foutcodes / Error Codes

200 OKVerzoek geslaagd.

201 CreatedResource aangemaakt.

400 Bad RequestOngeldige invoer of ontbrekende velden.

401 UnauthorizedSessie verlopen of ongeldige API-sleutel.

403 ForbiddenGeen rechten voor deze actie.

404 Not FoundResource niet gevonden.

429 Too Many RequestsSnelheidslimiet overschreden.

500 Internal Server ErrorServerfout. Probeer opnieuw.

Authenticatie / Authentication

Sessie-gebaseerde authenticatie via cookie en API-sleutels voor server-to-server integraties.

POST/api/auth/loginInloggen / Login

Request body (JSON)

Parameter	Type	Verplicht	Beschrijving
email	string	ja	E-mailadres van de gebruiker.
password	string	ja	Wachtwoord.

Voorbeeld verzoek / Example request

POST /api/auth/login
Content-Type: application/json

{
  "email": "jan@devries-bouw.nl",
  "password": "geheim123"
}

Antwoord / Response

{
  "success": true,
  "user": { "id": "...", "name": "Jan de Vries", "role": "owner" }
}
// Sets httpOnly cookie: bp_session

POST/api/auth/logoutUitloggen / Logout

Antwoord / Response

{ "success": true }
// Clears bp_session cookie

CRM / CRM

Contacten, deals en activiteiten beheren.

GET/api/dashboard/data?table=crm_contactsContacten ophalen / Get contacts

Query parameters

Parameter	Type	Verplicht	Beschrijving
table	string	ja	Waarde: crm_contacts
search	string	nee	Zoekterm op naam, e-mail of telefoon.

Antwoord / Response

{
  "data": [
    {
      "id": "uuid",
      "name": "Jan de Vries",
      "email": "jan@voorbeeld.nl",
      "phone": "+31612345678",
      "company": "De Vries Bouw",
      "status": "actief",
      "tags": ["bouw","klant"],
      "created_at": "2026-01-15T09:00:00Z"
    }
  ]
}

POST/api/dashboard/dataContact aanmaken / Create contact

Request body (JSON)

Parameter	Type	Verplicht	Beschrijving
table	string	ja	Waarde: crm_contacts
data.name	string	ja	Volledige naam.
data.email	string	nee	E-mailadres.
data.phone	string	nee	Telefoonnummer (E.164 formaat).
data.company	string	nee	Bedrijfsnaam.
data.tags	string[]	nee	Labels.

Voorbeeld verzoek / Example request

POST /api/dashboard/data
Content-Type: application/json

{
  "table": "crm_contacts",
  "data": {
    "name": "Pieter Bakker",
    "email": "pieter@bakker.nl",
    "phone": "+31612345679",
    "company": "Bakker Installaties",
    "tags": ["lood","installatie"]
  }
}

Antwoord / Response

{ "data": { "id": "uuid", ... }, "success": true }

PATCH/api/dashboard/dataContact bijwerken / Update contact

Request body (JSON)

Parameter	Type	Verplicht	Beschrijving
table	string	ja	Waarde: crm_contacts
id	string (UUID)	ja	ID van het contact.
data	object	ja	Velden om bij te werken.

Antwoord / Response

{ "success": true }

DELETE/api/dashboard/dataContact verwijderen / Delete contact

Request body (JSON)

Parameter	Type	Verplicht	Beschrijving
table	string	ja	Waarde: crm_contacts
id	string (UUID)	ja	ID van het contact.

Antwoord / Response

{ "success": true }

Facturatie / Invoicing

Facturen en offertes aanmaken, verzenden en beheren.

GET/api/dashboard/data?table=invoicesFacturen ophalen / Get invoices

Query parameters

Parameter	Type	Verplicht	Beschrijving
table	string	ja	Waarde: invoices

Antwoord / Response

{
  "data": [
    {
      "id": "uuid",
      "invoice_number": "F-2026-0042",
      "contact_name": "Jan de Vries",
      "amount_cents": 149500,
      "currency": "EUR",
      "status": "verstuurd",
      "due_date": "2026-02-15",
      "created_at": "2026-01-15T09:00:00Z"
    }
  ]
}

POST/api/dashboard/dataFactuur aanmaken / Create invoice

Request body (JSON)

Parameter	Type	Verplicht	Beschrijving
table	string	ja	Waarde: invoices
data.contact_name	string	ja	Naam van de klant.
data.amount_cents	number	ja	Bedrag in centen (excl. BTW).
data.currency	string	nee	Standaard: EUR.
data.due_date	string (ISO 8601)	nee	Vervaldatum.
data.items	InvoiceItem[]	nee	Regelitems.

Antwoord / Response

{ "data": { "id": "uuid", "invoice_number": "F-2026-0043", ... } }

POST/api/dashboard/invoices/sendFactuur verzenden / Send invoice

Request body (JSON)

Parameter	Type	Verplicht	Beschrijving
id	string (UUID)	ja	ID van de factuur.
channel	"email" \| "whatsapp"	ja	Verzendkanaal.

Antwoord / Response

{ "success": true, "message_id": "..." }

Agenda / Calendar

Afspraken inplannen, ophalen en bijwerken.

GET/api/dashboard/data?table=agenda_eventsAfspraken ophalen / Get appointments

Query parameters

Parameter	Type	Verplicht	Beschrijving
table	string	ja	Waarde: agenda_events
from	string (ISO 8601)	nee	Begin van de periode.
to	string (ISO 8601)	nee	Einde van de periode.

Antwoord / Response

{
  "data": [
    {
      "id": "uuid",
      "title": "Inspectie dak",
      "start_at": "2026-02-01T10:00:00Z",
      "end_at": "2026-02-01T11:00:00Z",
      "location": "Dorpsstraat 12, Amsterdam",
      "assigned_user_id": "uuid"
    }
  ]
}

POST/api/dashboard/dataAfspraak aanmaken / Create appointment

Request body (JSON)

Parameter	Type	Verplicht	Beschrijving
table	string	ja	Waarde: agenda_events
data.title	string	ja	Titel van de afspraak.
data.start_at	string (ISO 8601)	ja	Starttijd.
data.end_at	string (ISO 8601)	ja	Eindtijd.
data.location	string	nee	Locatie.
data.assigned_user_id	string (UUID)	nee	Toegewezen medewerker.

Antwoord / Response

{ "data": { "id": "uuid", ... } }

WhatsApp / WhatsApp

Berichten sturen en gesprekken ophalen via de WhatsApp Business API.

POST/api/webhook/whatsappWhatsApp webhook (inkomend) / Inbound webhook

Query parameters

Parameter	Type	Verplicht	Beschrijving
hub.mode	string	nee	subscribe — voor verificatie door Meta.
hub.challenge	string	nee	Wordt teruggestuurd bij verificatie.
hub.verify_token	string	nee	Geheim token ingesteld in Meta App.

Voorbeeld verzoek / Example request

// Inbound message from Meta
POST /api/webhook/whatsapp
X-Hub-Signature-256: sha256=...

{
  "entry": [{
    "changes": [{
      "value": {
        "messages": [{
          "from": "31612345678",
          "text": { "body": "Hoi, kan ik een offerte krijgen?" }
        }]
      }
    }]
  }]
}

Antwoord / Response

HTTP 200 OK

POST/api/dashboard/whatsapp/sendBericht sturen / Send message

Request body (JSON)

Parameter	Type	Verplicht	Beschrijving
to	string	ja	Telefoonnummer (E.164).
message	string	ja	Berichttekst.
template	string	nee	Naam van goedgekeurd WhatsApp template.
template_params	string[]	nee	Parameterwaardes voor het template.

Antwoord / Response

{ "success": true, "wa_message_id": "wamid...." }

GET/api/dashboard/data?table=conversationsGesprekken ophalen / Get conversations

Query parameters

Parameter	Type	Verplicht	Beschrijving
table	string	ja	Waarde: conversations
status	"active" \| "closed" \| "pending"	nee	Filter op status.

Antwoord / Response

{
  "data": [
    {
      "id": "uuid",
      "customer": { "name": "Jan de Vries", "phone": "+31612345678" },
      "status": "active",
      "last_message_at": "2026-03-01T14:22:00Z",
      "channel": "whatsapp"
    }
  ]
}

Rittenplanner / Route Planner

Ritten inplannen, routes optimaliseren en bestuurders volgen.

GET/api/dashboard/data?table=rp_ordersOpdrachten ophalen / Get orders

Query parameters

Parameter	Type	Verplicht	Beschrijving
table	string	ja	Waarde: rp_orders
date	string (YYYY-MM-DD)	nee	Filter op datum.
driver_id	string (UUID)	nee	Filter op bestuurder.

Antwoord / Response

{
  "data": [
    {
      "id": "uuid",
      "reference": "RIT-2026-0101",
      "pickup_address": "Hoofdstraat 1, Amsterdam",
      "delivery_address": "Keizersgracht 100, Amsterdam",
      "status": "onderweg",
      "driver_id": "uuid",
      "scheduled_at": "2026-03-01T08:00:00Z"
    }
  ]
}

POST/api/dashboard/dataRit aanmaken / Create trip

Request body (JSON)

Parameter	Type	Verplicht	Beschrijving
table	string	ja	Waarde: rp_orders
data.pickup_address	string	ja	Ophaaladres.
data.delivery_address	string	ja	Afleveradres.
data.scheduled_at	string (ISO 8601)	ja	Geplande vertrektijd.
data.driver_id	string (UUID)	nee	Toegewezen bestuurder.

Antwoord / Response

{ "data": { "id": "uuid", "reference": "RIT-2026-0102", ... } }

PATCH/api/dashboard/dataRitstatus bijwerken / Update trip status

Request body (JSON)

Parameter	Type	Verplicht	Beschrijving
table	string	ja	Waarde: rp_orders
id	string (UUID)	ja	ID van de rit.
data.status	"gepland" \| "onderweg" \| "afgeleverd" \| "geannuleerd"	ja	Nieuwe status.

Antwoord / Response

{ "success": true }

Modules — Snelnavigatie

Authenticatie CRM Facturatie Agenda WhatsApp Rittenplanner

Hulp nodig? / Need help?

Neem contact op via e-mail of WhatsApp voor technische ondersteuning bij API-integraties.

E-mail WhatsApp

Home Privacy Voorwaarden