Ga naar hoofdinhoud
QR-Verse
REST API

Genereer QR-codes op Schaal met Onze REST API

Integreer QR-code creatie, beheer en analyses in elke applicatie. RESTful JSON API met API-sleutel authenticatie, bulk ZIP-export en real-time webhooks.

POST /api/v1/qr-codes
{ "type": "url", "data": "https://example.com" }

De QR-Verse REST API stelt ontwikkelaars in staat om QR-codes programmatisch te maken, beheren en volgen. Exporteer tot 50 bestaande codes als ZIP-bestand via het bulk-exporteindpunt, ontvang realtime scanmeldingen via webhooks en krijg toegang tot gedetailleerde analytics. Authenticeer met een eenvoudige API-sleutel en begin binnen minuten met integreren met elke HTTP-client.

Maak een QR-code in seconden

Eén POST-verzoek is genoeg. Stuur uw data en ontvang een scanbare QR-code met een trackbare korte URL en downloadbare afbeelding.

Verzoek
cURL
curl -X POST \
https://qr-verse.com/api/v1/qr-codes \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Spring campaign",
"destination_url": "https://example.com"
}'
Antwoord
201 Created
{
"data": {
"id": "qr_abc123",
"name": "Spring campaign",
"qr_type": "url",
"destination_url": "https://example.com",
"is_active": true,
"redirect_slug": "abc123",
"tags": [],
"created_at": "2026-10-09T12:00:00Z"
}
}

Alles wat u nodig hebt om te bouwen

Een complete API voor het beheer van de volledige QR-code levenscyclus. Van aanmaken en stijlen tot scantracking en realtime meldingen.

Volledige CRUD-bewerkingen

QR-codes programmatisch aanmaken, lezen, bijwerken en verwijderen. Elk QR-type ondersteund - URL, vCard, WiFi, e-mail, SMS en meer.

Bulk ZIP-export

Exporteer tot 50 bestaande QR-codes als ZIP-bestand in één API-aanroep. Download PNG of SVG met behoud van de originele stijl.

Analytics API

Haal scandata programmatisch op. Totalen over een periode en een record per scan: tijdstip, land, stad, apparaattype, besturingssysteem, browser en UTM-parameters.

Webhook-events

Ontvang realtime HTTP-meldingen wanneer uw QR-codes worden gescand. Activeer workflows in uw CRM, analytics of automatiseringstools.

API-sleutelbeheer

Genereer, roteer en verwijder API-sleutels via uw dashboard. Pro- en Business-abonnementen ondersteunen meerdere sleutels voor verschillende omgevingen.

Snelheidslimiet

Het aanmaken van QR-codes via de API is beperkt tot 30 aanroepen per 60 seconden per API-sleutel. Daarboven antwoordt de API met status 429.

API-toegang per abonnement

API-toegang start bij Pro. Business voegt bulkimport vanuit een CSV-bestand in de web-app toe en hogere limieten voor webhooks en API-sleutels voor teamomgevingen.

Functie
Gratis
EUR 0/maand
Pro
4,99 €/maand
Business
12,99 €/maand
REST API-toegang
API-sleutelbeheer
Aanmaken / Lezen / Bijwerken / Verwijderen
Dynamische QR-codes met een bestemmings-URL
Ophalen van analyticsdata
Snelheidslimiet (codes aanmaken)030 / min30 / min
Bulk ZIP-export (tot 50 codes)
Webhook-meldingen
Meerdere API-sleutels
Begin met ProVergelijk alle abonnementen

Gebouwd voor uw stack

Of u nu een webshop beheert, sales pipelines bijhoudt of marketingcampagnes automatiseert - de QR-Verse API past naadloos in uw bestaande workflow.

E-commerceplatformen

Genereer automatisch QR-codes voor elk product in uw catalogus. Link naar productpagina's, voeg toe aan verpakking of embed in bonnen. Exporteer bestaande codes als ZIP-bestand via de API voor print- en verpakkingsworkflows.

Shopify, WooCommerce of maatwerk webshops

CRM & verkooptools

Maak gepersonaliseerde QR-codes voor verkoopmaterialen, visitekaartjes of klantportalen. Gebruik webhooks om scans te loggen als CRM-activiteiten en volg betrokkenheid per contact.

HubSpot, Salesforce, Pipedrive

Marketingautomatisering

Embed dynamische QR-codes in e-mailcampagnes, printadvertenties of evenementmaterialen. Haal scananalytics op via de API om campagne-ROI te meten naast uw bestaande marketingdata.

Mailchimp, ActiveCampaign, Zapier
Bekijk alle integraties en webhook-instellingen

Developer experience

Gebouwd door developers, voor developers. Voorspelbare responses, duidelijke documentatie en stabiele versioning zodat u met vertrouwen kunt shippen.

API-sleutels met scopes

Geef elke sleutel alleen de rechten die nodig zijn: qr:read, qr:write, qr:create en analytics:read. Een sleutel zonder de scope van een endpoint krijgt een 403, en een sessietoken van een ingelogde gebruiker wordt door de API niet geaccepteerd.

JSON-responses

Schone, consistente JSON-responses met een voorspelbare structuur. Elk endpoint retourneert hetzelfde formaat - data-, paginering- en foutobjecten waarop u kunt bouwen.

Foutafhandeling

Gestructureerde foutresponses met HTTP-statuscodes, machineleesbare foutcodes en voor mensen leesbare berichten. Los problemen snel op zonder te gokken.

API-versiebeheer

Versioned API-endpoints (v1) met achterwaartse compatibiliteitsgaranties. Breaking changes worden alleen in nieuwe hoofdversies uitgerold, zodat uw integratie stabiel blijft.

Beschikbare endpoints
GET/api/v1/qr-codes
POST/api/v1/qr-codes
GET/api/v1/qr-codes/:id
PATCH/api/v1/qr-codes/:id
DELETE/api/v1/qr-codes/:id
GET/api/v1/qr-codes/:id/scans

Veelgestelde vragen

Welke authenticatiemethode gebruikt de QR-Verse API?
De API gebruikt API-sleutelauthenticatie via Bearer-tokens. Voeg uw API-sleutel toe aan de Authorization-header als "Bearer UW_API_SLEUTEL". U kunt API-sleutels aanmaken en beheren via uw accountdashboard.
Welke QR-codetypen kan ik via de API aanmaken?
De API maakt dynamische QR-codes die doorverwijzen naar een bestemmings-URL: stuur een name en een destination_url naar POST /api/v1/qr-codes. Het veld type is een label (url, link, text, email, wifi, vcard, sms, phone, geo, event, crypto of social) en de inhoud is altijd de URL. Codes met eigen gegevens, zoals een vCard of een WiFi-netwerk, maakt u aan in de webapp.
Hoe werkt de bulk ZIP-export?
Gebruikers van een Pro- of Business-abonnement kunnen tot 50 bestaande QR-codes exporteren als ZIP-bestand via POST /api/qr/bulk-export, met een sessie of een API-sleutel met de scope qr:read. Geef de ID's op van de te exporteren codes en kies PNG- of SVG-formaat. De API retourneert een ZIP-download met elke code als apart bestand, met het originele ontwerp behouden.
Wat gebeurt er als ik de snelheidslimiet bereik?
Het aanmaken van een code (POST /api/v1/qr-codes) is beperkt tot 30 aanroepen per venster van 60 seconden per API-sleutel. Daarboven antwoordt de API met status 429 en de melding "Rate limit exceeded". De antwoorden bevatten geen rate-limit-headers en geen resettijd: wacht een minuut en probeer het opnieuw.
Kan ik de weergave van QR-codes aanpassen via de API?
Niet via de v1-API. Een code die via de API is aangemaakt, begint met de standaardstijl (zwart op wit); u kunt de stijl daarna aanpassen in de webapp. Kleuren, foutcorrectie en uitvoerformaat zijn geen parameters van POST /api/v1/qr-codes.
Hoe werken webhooks voor scangebeurtenissen?
Gebruikers van Pro- en Business-abonnementen kunnen webhook-URL's registreren via het dashboard. Wanneer een van uw QR-codes wordt gescand, sturen we een POST-aanvraag naar uw webhook-URL met scangegevens: het event en een tijdstempel, plus de ID en naam van de QR-code, land en stad, apparaattype, besturingssysteem, browser, of de scan uniek is en de UTM-parameters (geen referrer). Webhooks gebruiken HMAC-handtekeningen voor verificatie.
Is de API beschikbaar op het gratis abonnement?
Nee. API-toegang vereist een Pro-abonnement (4,99 €/maand) of Business-abonnement (12,99 €/maand). Het gratis abonnement bevat de webgebaseerde QR-generator maar geen programmatische API-toegang.
Kan ik analyticsdata ophalen via de API?
Ja. Zowel Pro- als Business-abonnementen bevatten API-toegang tot scananalytics, met een sleutel die de scope analytics:read heeft. GET /api/v1/qr-codes/:id/scans geeft de scans van een QR-code pagina voor pagina terug (tijdstip, land, stad, apparaattype, besturingssysteem, browser, uniek of niet, UTM-parameters) en een samenvatting met het totaal aantal scans, de scans en unieke scans in de periode en de lengte van de periode. Een uitsplitsing per dag, week of maand en de verwijzer zitten er niet in: u telt de records zelf bij elkaar op.

QR-codes integreren in uw workflow

De QR-Verse REST API laat uw QR-codes programmatisch genereren, beheren en scananalytics ophalen. Elke bewerking beschikbaar in het dashboard is ook beschikbaar via API, wat betekent dat uw ontwikkelteam QR-codegeneratie direct kan inbouwen in interne tools, e-commerceplatforms, fulfilmentpijplijnen of SaaS-producten zonder handmatige stappen.

Veelvoorkomende integratiepatronen omvatten programmatische generatie - het aanmaken van unieke QR-codes, één verzoek per keer, elk met een unieke doel-URL en optionele aangepaste metadata. Dit is ideaal voor productserienummers, ticketsystemen of loyaliteitskaartensprogramma's waarbij elk fysiek item zijn eigen scanbare code nodig heeft. De API retourneert elk gegenereerd code als SVG of PNG in de antwoordbody.

Het scananalytics-endpoint geeft real-time toegang tot dezelfde data die zichtbaar is in het dashboard - totale scans, unieke scans, geografische verdeling, apparaatverdeling en tijdreeksgegevens - allemaal in gestructureerde JSON. Dit betekent dat u QR-scangebeurtenissen direct kunt doorsturen naar uw eigen datawarehouse, CRM of rapportagetool. Webhook-ondersteuning is beschikbaar op Pro- en Business-niveau.

De API is bewust klein: zes endpoints onder /api/v1, JSON in en uit, en een API-sleutel met scopes voor toegang. De endpoints staan op deze pagina en het voorbeeld hieronder toont een aanvraag en het antwoord. Er zijn geen SDK-pakketten en geen gehoste interactieve documentatie: een gewone HTTP-client zoals cURL of fetch is genoeg.

Pro-abonnement vereist

Haal uw API-sleutel op

Meld u aan voor een Pro- of Business-abonnement, genereer uw API-sleutel via het dashboard en begin binnen enkele minuten met aanroepen.

Begin met bouwen

Ontdek meer functies

Bulk QR Code Generator

Genereer honderden QR-codes vanuit CSV in seconden

Dynamic QR Codes

Werk QR-bestemmingen bij zonder herdruk

QR Code Analytics

Volg scans, locaties en apparaten in real-time