Data synchronisatie

Overzicht

Met de Flixer API kun je data ophalen voor synchronisatie met externe systemen zoals:

CRM systemen
Business Intelligence tools
Google Sheets of Excel
Zapier / Make automations

Beschikbare data

Endpoint	Beschrijving	Scope
`GET /leads`	Alle leads (offerte-fase: request, contacted, quote_sent, inspection, lost)	`leads:read`
`GET /work-items`	Alle opdrachten (uitvoer-fase: pending, scheduled, in_progress, completed, cancelled)	`work-items:read`
`GET /address`	Alle adressen	`full`

Leads ophalen

GET https://api.flixerpro.io/v1/api/leads

Query parameters:

Parameter	Type	Default	Max	Beschrijving
`limit`	number	50	100	Aantal resultaten

curl -X GET "https://api.flixerpro.io/v1/api/leads?limit=100" \
  -H "X-API-Key: jouw_api_sleutel"

async function getLeads(limit = 50) {
  const response = await fetch(
    `https://api.flixerpro.io/v1/api/leads?limit=${limit}`,
    {
      headers: {
        "X-API-Key": process.env.FLIXER_API_KEY
      }
    }
  );

  const { data, limit: returnedLimit } = await response.json();
  return data;
}

import requests
import os

def get_leads(limit=50):
    response = requests.get(
        f"https://api.flixerpro.io/v1/api/leads?limit={limit}",
        headers={"X-API-Key": os.environ["FLIXER_API_KEY"]}
    )
    return response.json()["data"]

Response:

{
  "data": [
    {
      "id": "WKIabc123...",
      "title": "Lekkage badkamer",
      "status": "request",
      "priority": "high",
      "receivedAt": "2026-03-27T10:30:00.000Z",
      "customer": {
        "id": "CUSabc123...",
        "name": "Jan de Vries",
        "email": "[email protected]",
        "phone": "+31612345678"
      },
      "address": {
        "id": "ADRabc123...",
        "street": "Keizersgracht",
        "streetNumber": "123",
        "postalCode": "1015 CJ",
        "city": "Amsterdam"
      }
    }
  ],
  "limit": 50
}

Opdrachten ophalen

GET https://api.flixerpro.io/v1/api/work-items

Werkt identiek aan /leads, maar retourneert opdrachten die verder zijn in het proces (ingepland, in uitvoering, afgerond).

Synchronisatie strategieen

Periodieke sync

Poll de API op vaste intervallen (bijv. elke 5 minuten):

const SYNC_INTERVAL = 5 * 60 * 1000; // 5 minuten

async function syncLeads() {
  const leads = await getLeads(100);

  for (const lead of leads) {
    await upsertToCRM(lead);
  }

  console.log(`${leads.length} leads gesynchroniseerd`);
}

// Start periodieke sync
setInterval(syncLeads, SYNC_INTERVAL);
syncLeads(); // Direct eerste sync

Houd rekening met rate limits. Poll niet vaker dan nodig.

Incremental sync

Houd lokaal bij welke items je al hebt en filter op receivedAt:

let lastSyncTime = loadLastSyncTime(); // Uit database/file

async function incrementalSync() {
  const leads = await getLeads(100);

  const newLeads = leads.filter(
    lead => new Date(lead.receivedAt) > lastSyncTime
  );

  for (const lead of newLeads) {
    await upsertToCRM(lead);
  }

  if (newLeads.length > 0) {
    lastSyncTime = new Date();
    saveLastSyncTime(lastSyncTime);
  }

  console.log(`${newLeads.length} nieuwe leads`);
}

Voorbeeld: Google Sheets

Synchroniseer leads naar Google Sheets met Apps Script:

function syncFlixerLeads() {
  const apiKey = PropertiesService.getScriptProperties().getProperty('FLIXER_API_KEY');

  const response = UrlFetchApp.fetch('https://api.flixerpro.io/v1/api/leads?limit=100', {
    headers: { 'X-API-Key': apiKey }
  });

  const { data } = JSON.parse(response.getContentText());
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Leads');

  // Headers
  if (sheet.getLastRow() === 0) {
    sheet.appendRow(['ID', 'Titel', 'Klant', 'Email', 'Telefoon', 'Stad', 'Status', 'Ontvangen']);
  }

  // Data
  const existingIds = sheet.getRange('A:A').getValues().flat();

  for (const lead of data) {
    if (!existingIds.includes(lead.id)) {
      sheet.appendRow([
        lead.id,
        lead.title,
        lead.customer?.name,
        lead.customer?.email,
        lead.customer?.phone,
        lead.address?.city,
        lead.status,
        lead.receivedAt
      ]);
    }
  }
}

Stel een trigger in om syncFlixerLeads automatisch te draaien (bijv. elk uur).

Best practices

Cache responses waar mogelijk

Als je dezelfde data meerdere keren nodig hebt, cache de response lokaal in plaats van herhaalde API calls.

Gebruik idempotente upserts

Gebruik het id veld als unieke key bij het synchroniseren. Check of een item al bestaat voordat je het toevoegt.

Log sync resultaten

Houd bij wanneer je laatst hebt gesynchroniseerd en hoeveel items zijn verwerkt. Dit helpt bij debugging.

Handel fouten graceful af

Als een sync mislukt, log de fout en probeer het later opnieuw. Stop niet de hele sync bij een enkel item dat faalt.

Aan de slag

Handleidingen

Referentie

Overzicht

Beschikbare data

Leads ophalen

Opdrachten ophalen

Synchronisatie strategieen

Periodieke sync

Incremental sync

Voorbeeld: Google Sheets

Best practices

​Overzicht

​Beschikbare data

​Leads ophalen

​Opdrachten ophalen

​Synchronisatie strategieen

​Periodieke sync

​Incremental sync

​Voorbeeld: Google Sheets

​Best practices

Overzicht

Beschikbare data

Leads ophalen

Opdrachten ophalen

Synchronisatie strategieen

Periodieke sync

Incremental sync

Voorbeeld: Google Sheets

Best practices