QR Forge API documentatie

De QR Forge API ondersteunt QR-generatie voor url en text, als losse call of in bulk via CSV. Tracking, analytics per scan, logo-overlay, teams en webhooks vallen buiten deze eerste versie.

Maak eerst een account aan via e-mail + 6-cijferige login-code. Daarna kun je in het dashboard een API key aanmaken. Gebruik die key in de header:

Authorization: Bearer qrf_live_YOUR_API_KEY

Ga naar /dashboard/api-keys om een key aan te maken, te roteren of in te trekken. De volledige key wordt maar één keer getoond.

curl -X POST https://qrforge.nl/api/v1/qr \
  -H "Authorization: Bearer qrf_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "url",
    "value": "https://example.com",
    "format": "png",
    "size": 512
  }'

curl -X POST https://qrforge.nl/api/v1/qr/bulk \
  -H "Authorization: Bearer qrf_live_YOUR_API_KEY" \
  -F "csv=@codes.csv"

CSV mag via multipart upload of als raw text/csv-body worden aangeleverd.

Geeft het huidige maandverbruik, resterende ruimte en per-minute rate limit terug op basis van het pakket van het account.

• authentication_required
• invalid_api_key
• validation_error
• rate_limit_exceeded
• monthly_limit_exceeded
• bulk_limit_exceeded
• unsupported_format
• invalid_csv
• internal_error

Ondersteunde headers zijn value, type en filename. Gebruik bij voorkeur een headerregel zodat duidelijk is welke kolommen je meestuurt.

• value is verplicht en bevat de URL of tekst die in de QR-code moet komen.
• type is optioneel en mag url of text zijn. Laat je deze weg, dan gebruiken we standaard url.
• filename is optioneel en bepaalt de bestandsnaam van het gegenereerde bestand in de ZIP-download. Zonder filename gebruikt QR Forge automatisch een veilige naam.

Ondersteunde combinaties met header zijn bijvoorbeeld value, value,type, value,filename en value,type,filename.

value,type,filename
https://example.com,url,example-homepage
Hello world,text,hello-world
https://qrforge.nl/url,qrforge-campaign

value,filename
https://example.com,example-homepage
https://campaign.example/spring,spring-campaign
https://qrforge.nl/docs,docs-link

value
https://example.com
https://qrforge.nl
https://campaign.example/launch

Gebruik JSON voor single requests en multipart/form-data of raw text/csv voor bulk.

• Roteer API keys periodiek en trek ongebruikte keys in.
• Gebruik alleen http en https voor type url.
• Valideer CSV vooraf bij grote imports.
• Bewaar response-IDs van bulk jobs om later status op te vragen.