Ga naar hoofdinhoud
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-bewerkingen en real-time webhooks. Van een enkele code tot 500 per verzoek.

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. Genereer tot 500 codes per verzoek met bulk-endpoints, ontvang realtime scanmeldingen via webhooks en krijg toegang tot gedetailleerde analytics. Authenticeer met een eenvoudige API-sleutel en begin binnen minuten met integreren - met SDKs voor Node.js, Python en cURL-voorbeelden in de documentatie.

Maak een QR-code in seconden

Eén POST-verzoek is genoeg. Stuur je 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 '{
"type": "url",
"data": "https://example.com",
"style": { "foreground": "#238636" }
}'
Antwoord
201 Created
{
"id": "qr_abc123",
"type": "url",
"shortUrl": "https://qr-verse.com/r/abc123",
"image": "https://qr-verse.com/api/v1/qr-codes/qr_abc123/image.svg"
}

Alles wat je 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.

Bulkbewerkingen

Maak tot 500 QR-codes in één API-aanroep. Ideaal voor e-commerce-catalogi, evenementstickets of voorraadbeheer.

Analytics API

Haal scandata programmatisch op. Totale scans, scans over tijd, geografische uitsplitsing, apparaattypen en referrer-data.

Webhook-events

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

API-sleutelbeheer

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

Snelheidslimiet

Duidelijke rate-limit-headers bij elke response. 30 aanroepen per 60 seconden per API-sleutel. X-RateLimit-Limit, X-RateLimit-Remaining en X-RateLimit-Reset bij elke aanroep.

API-toegang per abonnement

API-toegang start bij Pro. Business ontgrendelt bulkbewerkingen, webhooks en meerdere API-sleutels voor teamomgevingen.

Functie
Gratis
EUR 0/maand
Pro
EUR 4,99/maand
Business
EUR 12,99/maand
REST API-toegang
API-sleutelbeheer
Aanmaken / Lezen / Bijwerken / Verwijderen
Alle QR-typen (URL, vCard, WiFi...)
Ophalen van analyticsdata
Snelheidslimiet030 / min30 / min
Bulkbewerkingen (per aanroep)Tot 500
Webhook-meldingen
Meerdere API-sleutels
White-label API-responses
OpenAPI / Swagger-documentatie

Gebouwd voor jouw stack

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

E-commerceplatformen

Genereer automatisch QR-codes voor elk product in je catalogus. Link naar productpagina's, voeg toe aan verpakking of embed in bonnen. Maak 500 codes per API-aanroep voor grote voorraden.

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 je bestaande marketingdata.

Mailchimp, ActiveCampaign, Zapier

Developer experience

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

OpenAPI-documentatie

Volledige OpenAPI 3.0-specificatie met interactieve Swagger UI. Test endpoints direct vanuit de docs. Elk aanvraag- en antwoordschema gedocumenteerd.

JSON-responses

Schone, consistente JSON-responses met een voorspelbare structuur. Elk endpoint retourneert hetzelfde formaat - data-, paginering- en foutobjecten waarop je 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 je 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 je API-sleutel toe aan de Authorization-header als "Bearer JOUW_API_SLEUTEL". Je kunt API-sleutels aanmaken en beheren via je accountdashboard.
Welke QR-codetypen kan ik via de API aanmaken?
Alle QR-codetypen die beschikbaar zijn in de webinterface zijn ook beschikbaar via de API: URL, vCard (contactkaarten), WiFi-inloggegevens, e-mail, SMS, platte tekst en meer. Elk type heeft zijn eigen dataschema gedocumenteerd in de OpenAPI-specificatie.
Hoe werkt het bulk aanmaken van QR-codes?
Business-abonnementgebruikers kunnen een array van maximaal 500 QR-codeobjecten versturen in één POST-aanvraag naar het bulk-endpoint. Elke code kan een ander type, data en opmaak hebben. De API retourneert alle aangemaakte codes met hun ID's en korte URL's.
Wat gebeurt er als ik de snelheidslimiet bereik?
Elke API-response bevat rate-limit-headers: X-RateLimit-Limit, X-RateLimit-Remaining en X-RateLimit-Reset. Als je je limiet overschrijdt, retourneert de API een 429-statuscode met de resettijdstempel. De limiet is 30 aanroepen per 60 seconden per API-sleutel.
Kan ik de weergave van QR-codes aanpassen via de API?
Ja. De API accepteert stijlparameters zoals voorgrondkleur, achtergrondkleur, foutcorrectieniveau en uitvoerformaat (SVG of PNG). Dezelfde aanpassingsopties die beschikbaar zijn in de webgenerator zijn ook beschikbaar via de API.
Hoe werken webhooks voor scangebeurtenissen?
Business-abonnementgebruikers kunnen webhook-URL's registreren via het dashboard. Wanneer een van je QR-codes wordt gescand, sturen we een POST-aanvraag naar je webhook-URL met scangegevens: QR-code-ID, tijdstempel, locatie (land/stad), apparaattype en referrer. Webhooks gebruiken HMAC-handtekeningen voor verificatie.
Is de API beschikbaar op het gratis abonnement?
Nee. API-toegang vereist een Pro-abonnement (EUR 4,99/maand) of Business-abonnement (EUR 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. Je kunt totale scantelling, scans over tijd (dagelijks/wekelijks/maandelijks), geografische uitsplitsing per land en stad, apparaattypen en topverwijzers ophalen voor al je QR-codes.

QR-codes integreren in je workflow

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

Veelvoorkomende integratiepatronen omvatten batchgeneratie - het aanmaken van honderden of duizenden unieke QR-codes in één API-aanroep, 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 je QR-scangebeurtenissen direct kunt doorsturen naar je eigen datawarehouse, CRM of rapportagetool. Webhook-ondersteuning is beschikbaar op Business-niveau.

Ontwikkelaarservaring was vanaf het begin een ontwerpprioriteit. De OpenAPI-specificatie wordt gepubliceerd op een stabiele URL en gesynchroniseerd met elke API-release. Officiële SDK-pakketten zijn beschikbaar voor Node.js, Python en PHP. Interactieve documentatie met live verzoekuitvoering is direct beschikbaar in het QR-Verse dashboard zodra je een API-sleutel hebt. De meeste ontwikkelaars voltooien hun eerste integratie in minder dan een uur.

Pro-abonnement vereist

Haal je API-sleutel op

Meld je aan voor een Pro- of Business-abonnement, genereer je API-sleutel via het dashboard en begin binnen enkele minuten met aanroepen. Volledige OpenAPI-documentatie inbegrepen.

Begin met bouwen