QR Code API Documentation

Crea codici QR

Crea un codice QR dinamico per URL e destinazioni gestite, oppure un codice QR statico per WiFi.

POST https://createqr.app/api/v1/create

Invia solo JSON. Per l'autenticazione tramite chiave, l'header è la best practice. I campi della chiave nel body sono presenti per compatibilità con le integrazioni esistenti.

Guida rapida (cURL)

Questo esempio di URL dinamico è il modo più veloce per iniziare.

curl -sS -X POST 'https://createqr.app/api/v1/create' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ck_live_XXXXXXXXXXXXXXXXXXXXXXXX' \
  -d '{"data":"https://createqr.app","qrtype":"dynamic"}'

Autenticazione e compatibilità

Consigliato: Authorization: Bearer <key>
Accettato anche: X-API-Key
Fallback JSON: apikey o api_key
Content-Type deve essere application/json
I metodi non POST restituiscono 405 method_not_allowed

Parametri principali

Parametro	Tipo	Predefinito	Descrizione
`apikey`	String	`Obbligatorio`	Chiave API segreta. Consigliata nell'header Authorization (Bearer). Sono accettati anche apikey/api_key nel body JSON.
`data`	String	`Obbligatorio`	Contenuto da codificare. Il QR dinamico richiede un URL valido. Il QR statico accetta solo stringhe WiFi.
`qrtype`	String	`dynamic`	Modalità QR: dynamic per URL e destinazioni gestite, oppure static solo per WiFi.
`title`	String	`Facoltativo`	Titolo del QR mostrato nella dashboard (troncato a 120 caratteri).
`folderid`	Number	`Facoltativo`	ID numerico positivo della cartella associata al tuo account.

Parametri colore e forma

Parametro	Tipo	Predefinito	Descrizione
`transparent`	String/Bool	`off`	Sono accettati on/off, true/false, 1/0, yes/no.
`backcolor`	String	`#FFFFFF`	Colore esadecimale di sfondo nel formato #RRGGBB.
`frontcolor`	String	`#000000`	Colore esadecimale principale dei punti nel formato #RRGGBB.
`gradient`	String/Bool	`off`	Abilita il gradiente a due colori dei punti.
`radial`	String/Bool	`off`	Abilita il gradiente radiale (funziona quando il gradiente è attivo).
`gradient_color`	String	`#15A97C`	Secondo colore del gradiente in #RRGGBB.
`marker_out_color`	String	`#000000`	Colore della cornice attorno ai punti angolari in #RRGGBB format.
`marker_in_color`	String	`#000000`	Colore dei punti angolari in #RRGGBB format.
`pattern`	String	`default`	Preset di stile dei punti del corpo. `default` `circle` `star` `diamond` `sparkle` `danger` `cross` `plus` `x` `heart` `shake` `blob` `special-circle-orizz` `special-circle-vert` `special-circle` `special-diamond` `ribbon` `oriental` `ellipse`
`marker`	String	`default`	Stile della cornice attorno ai punti angolari. `corner_1` `corner_2` `corner_3` `corner_4` `corner_5` `corner_6` `corner_7` `corner_8`
`marker_in`	String	`default`	Tipo dei punti angolari. `corner_in_1` `corner_in_2` `corner_in_3` `corner_in_4` `corner_in_5` `corner_in_6` `corner_in_7` `corner_in_8`
`optionlogo`	String	`none`	none, percorso consigliato a una filigrana SVG locale, percorso legacy a un PNG locale oppure dati immagine base64. `none` `/images/watermarks/v2/01-link.svg` `/images/watermarks/v2/02-location.svg` `/images/watermarks/v2/03-email.svg` `/images/watermarks/v2/04-whatsapp.svg` `/images/watermarks/v2/05-wifi.svg` `/images/watermarks/v2/06-vcard.svg` `/images/watermarks/v2/07-menu.svg` `/images/watermarks/v2/08-app.svg` `/images/watermarks/v2/09-video.svg` `/images/watermarks/v2/10-feedback.svg` `/images/watermarks/v2/11-event.svg` `/images/watermarks/v2/12-coupon.svg` `/images/watermarks/v2/13-music.svg` `/images/watermarks/v2/14-social.svg` `/images/watermarks/v2/15-paypal.svg` `/images/watermarks/v2/16-bitcoin.svg` `/images/watermarks/v2/17-scan.svg` `data:image/*;base64,...`
`no_logo_bg`	String/Bool	`on`	Rimuove lo sfondo del logo.

Parametri cornice

Parametro	Tipo	Predefinito	Descrizione
`outer_frame`	String	`none`	Preset di stile della cornice. `none` `svg_frame_01` `svg_frame_02` `svg_frame_03` `svg_frame_04` `svg_frame_05` `svg_frame_06` `svg_frame_07` `svg_frame_08` `svg_frame_09` `svg_frame_10` `svg_frame_11` `svg_frame_12` `svg_frame_13` `svg_frame_14` `svg_frame_15` `svg_frame_16` `svg_frame_19` `svg_frame_22` `svg_frame_23` `svg_frame_26` `svg_frame_27` `svg_frame_28` `svg_frame_29` `svg_frame_30` `svg_frame_31` `svg_frame_33` `svg_frame_34` `svg_frame_35` `svg_frame_36` `svg_frame_38` `svg_frame_42` `caption_only_v1` `classic_thin_outline_v1` `classic_rounded_outline_v1` `classic_bottom_bar_v1` `classic_top_bar_v1` `classic_corner_brackets_v1` `classic_speech_bubble_v1` `colorful_blue_panel_v1` `colorful_teal_accents_v1` `colorful_coral_accents_v1` `colorful_botanical_v1` `colorful_celebration_v1` `colorful_cafe_v1` `illustrated_circle_v1` `illustrated_brackets_bottom_v1` `illustrated_speech_label_v1` `illustrated_brackets_top_v1` `illustrated_banner_filled_v1` `illustrated_banner_outline_v1` `illustrated_cloche_v1` `illustrated_beer_v1` `illustrated_chef_v1` `illustrated_shop_v1` `illustrated_drink_v1` `illustrated_coffee_v1` `illustrated_receipt_v1` `illustrated_arrow_v1` `illustrated_gift_v1` `illustrated_cinema_v1` `colorful_womens_day_mimosa_v1` `colorful_womens_day_venus_blossom_v1` `colorful_womens_day_ribbon_v1` `colorful_womens_day_floral_portrait_v1` `colorful_womens_day_tulip_garden_v1` `colorful_halloween_pumpkin_v1` `colorful_halloween_friendly_ghost_v1` `colorful_halloween_witch_hat_v1` `colorful_halloween_bat_moon_v1` `colorful_halloween_haunted_house_v1` `colorful_tequila_day_agave_v1` `colorful_tequila_day_margarita_v1` `colorful_tequila_day_bottle_v1` `colorful_tequila_day_lime_sun_v1` `colorful_tequila_day_desert_cactus_v1` `colorful_new_year_fireworks_v1` `colorful_new_year_champagne_v1` `colorful_new_year_midnight_clock_v1` `colorful_new_year_party_hat_v1` `colorful_new_year_disco_ball_v1` `colorful_valentines_heart_wings_v1` `colorful_valentines_love_letter_v1` `colorful_valentines_swan_pair_v1` `colorful_valentines_heart_lock_v1` `colorful_valentines_rose_v1` `colorful_easter_painted_egg_v1` `colorful_easter_spring_bunny_v1` `colorful_easter_egg_basket_v1` `colorful_easter_hatching_chick_v1` `colorful_easter_spring_wreath_v1` `colorful_april_fools_jester_v1` `colorful_april_fools_jack_in_box_v1` `colorful_april_fools_moustache_glasses_v1` `colorful_april_fools_comedy_mask_v1` `colorful_april_fools_pop_up_flower_v1` `colorful_eid_crescent_lantern_v1` `colorful_eid_dates_v1` `colorful_eid_star_medallion_v1` `colorful_eid_mosque_v1` `colorful_eid_festival_garland_v1` `colorful_labor_day_hard_hat_v1` `colorful_labor_day_crossed_tools_v1` `colorful_labor_day_handshake_v1` `colorful_labor_day_gear_v1` `colorful_labor_day_raised_fist_v1` `colorful_islamic_mihrab_v1` `colorful_islamic_open_book_v1` `colorful_islamic_prayer_beads_v1` `colorful_islamic_pierced_lantern_v1` `colorful_islamic_minarets_v1` `colorful_songkran_water_bowl_v1` `colorful_songkran_elephant_v1` `colorful_songkran_jasmine_garland_v1` `colorful_songkran_water_splash_v1` `colorful_songkran_temple_roof_v1` `colorful_fathers_day_tie_v1` `colorful_fathers_day_bow_tie_v1` `colorful_fathers_day_fishing_v1` `colorful_fathers_day_grill_v1` `colorful_fathers_day_trophy_v1` `colorful_pancasila_golden_star_v1` `colorful_pancasila_unity_chain_v1` `colorful_pancasila_banyan_v1` `colorful_pancasila_bull_v1` `colorful_pancasila_rice_cotton_v1` `colorful_indonesia_independence_red_white_ribbons_v1` `colorful_indonesia_independence_monas_v1` `colorful_indonesia_independence_bunting_v1` `colorful_indonesia_independence_rosette_v1` `colorful_indonesia_independence_bamboo_v1` `colorful_hung_kings_bronze_drum_v1` `colorful_hung_kings_lotus_v1` `colorful_hung_kings_temple_gate_v1` `colorful_hung_kings_sacred_mountains_v1` `colorful_hung_kings_rice_offerings_v1` `colorful_harvest_golden_wheat_v1` `colorful_harvest_cornucopia_v1` `colorful_harvest_orchard_basket_v1` `colorful_harvest_sweetcorn_v1` `colorful_harvest_field_sunrise_v1` `colorful_thanksgiving_turkey_v1` `colorful_thanksgiving_orchard_pie_v1` `colorful_thanksgiving_oak_acorns_v1` `colorful_thanksgiving_autumn_wreath_v1` `colorful_thanksgiving_candle_table_v1` `colorful_carnival_feather_mask_v1` `colorful_carnival_jester_v1` `colorful_carnival_festival_fan_v1` `colorful_carnival_parade_drum_v1` `colorful_carnival_confetti_v1` `colorful_holi_powder_burst_v1` `colorful_holi_gulal_bowls_v1` `colorful_holi_rangoli_v1` `colorful_holi_water_colours_v1` `colorful_holi_petal_rain_v1` `colorful_columbus_day_tall_ship_v1` `colorful_columbus_day_compass_rose_v1` `colorful_columbus_day_sea_chart_v1` `colorful_columbus_day_sextant_v1` `colorful_columbus_day_three_sails_v1` `colorful_christmas_fir_tree_v1` `colorful_christmas_baubles_v1` `colorful_christmas_holly_wreath_v1` `colorful_christmas_gingerbread_v1` `colorful_christmas_snowy_cottage_v1` `colorful_chinese_new_year_lanterns_v1` `colorful_chinese_new_year_dragon_v1` `colorful_chinese_new_year_lion_dance_v1` `colorful_chinese_new_year_plum_blossoms_v1` `colorful_chinese_new_year_gold_ingots_v1` `colorful_vietnamese_new_year_apricot_blossoms_v1` `colorful_vietnamese_new_year_banh_chung_v1` `colorful_vietnamese_new_year_spring_bouquet_v1` `colorful_vietnamese_new_year_lucky_envelopes_v1` `colorful_vietnamese_new_year_kumquat_v1` `colorful_food_drink_plate_v1` `colorful_food_drink_cloche_v1` `colorful_food_drink_takeaway_coffee_v1` `colorful_food_drink_mug_v1` `colorful_food_drink_menu_v1` `colorful_travel_suitcase_v1` `colorful_travel_backpack_v1` `colorful_travel_luggage_v1` `colorful_travel_balloon_v1` `colorful_travel_location_v1` `colorful_shopping_bag_v1` `colorful_shopping_cart_v1` `colorful_shopping_gift_v1` `colorful_shopping_storefront_v1` `colorful_shopping_delivery_truck_v1` `colorful_technology_cloud_v1` `colorful_technology_atom_v1` `colorful_technology_phone_hand_v1` `colorful_technology_monitor_v1` `colorful_technology_chat_v1` `colorful_wellness_medicine_v1` `colorful_wellness_medical_bag_v1` `colorful_wellness_care_hands_v1` `colorful_wellness_wellness_leaves_v1` `colorful_wellness_health_pulse_v1` `colorful_celebration_teddy_bear_v1` `colorful_celebration_bunting_v1` `colorful_celebration_balloons_v1` `colorful_celebration_ribbon_v1` `colorful_celebration_cake_v1` `colorful_creative_stationery_v1` `colorful_creative_artist_palette_v1` `colorful_creative_camera_v1` `colorful_creative_music_v1` `colorful_creative_book_v1`
`framelabel`	String	`SCAN ME`	Etichetta di testo della cornice (troncata a 80 caratteri).
`label_font`	String	`Arial, Helvetica, sans-serif`	Stack di font per l'etichetta della cornice.
`custom_frame_color`	String/Bool	`off`	Abilita un colore personalizzato per la cornice.
`framecolor`	String	`#000000`	Colore esadecimale della cornice nel formato #RRGGBB.

Esempi di richieste di creazione

Esempio: QR semplice

No-frills, fast scan

Request Method:

POST

Request URL:

https://createqr.app/api/v1/create

Request Parameters:

All parameters need to be sent as a JSON object in the request body.

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "data": "https://createqr.app",
    "qrtype": "dynamic",
    "title": "Launch Landing QR",
    "transparent": "off",
    "backcolor": "#FFFFFF",
    "frontcolor": "#000000",
    "marker_out_color": "#000000",
    "marker_in_color": "#000000",
    "pattern": "default",
    "marker": "corner_1",
    "marker_in": "corner_in_1",
    "optionlogo": "none"
}

Request Outcome

Esempio: QR WiFi statico

Built for distance

Request Method:

POST

Request URL:

https://createqr.app/api/v1/create

Request Parameters:

All parameters need to be sent as a JSON object in the request body.

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "data": "WIFI:T:WPA;S:CreateQR Guest;P:guest-2026;H:false;;",
    "qrtype": "static",
    "title": "Guest Wi-Fi QR",
    "transparent": "off",
    "backcolor": "#0B1220",
    "frontcolor": "#FFFFFF",
    "marker_out_color": "#F4C84A",
    "marker_in_color": "#F4C84A",
    "pattern": "circle",
    "marker": "corner_3",
    "marker_in": "corner_in_3",
    "optionlogo": "none"
}

Request Outcome

Brand Color

Theme-aligned campaign

Request Method:

POST

Request URL:

https://createqr.app/api/v1/create

Request Parameters:

All parameters need to be sent as a JSON object in the request body.

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "data": "https://createqr.app/pricing",
    "qrtype": "dynamic",
    "title": "Pricing QR",
    "transparent": "off",
    "backcolor": "#EAF4FF",
    "frontcolor": "#033895",
    "marker_out_color": "#15A97C",
    "marker_in_color": "#15A97C",
    "pattern": "special-circle-orizz",
    "marker": "corner_4",
    "marker_in": "corner_in_4",
    "optionlogo": "none"
}

Request Outcome

Esempio: Colore + logo

Preset watermark icon

Request Method:

POST

Request URL:

https://createqr.app/api/v1/create

Request Parameters:

All parameters need to be sent as a JSON object in the request body.

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "data": "https://createqr.app/features",
    "qrtype": "dynamic",
    "title": "Feature Tour QR",
    "transparent": "off",
    "backcolor": "#033895",
    "frontcolor": "#FFFFFF",
    "marker_out_color": "#669DF4",
    "marker_in_color": "#669DF4",
    "pattern": "ribbon",
    "marker": "corner_5",
    "marker_in": "corner_in_5",
    "optionlogo": "/images/watermarks/v2/01-link.svg"
}

Request Outcome

Esempio: QR campagna con cornice

Poster-ready "SCAN ME"

Request Method:

POST

Request URL:

https://createqr.app/api/v1/create

Request Parameters:

All parameters need to be sent as a JSON object in the request body.

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "data": "https://createqr.app/pricing",
    "qrtype": "dynamic",
    "title": "Pricing Poster QR",
    "transparent": "off",
    "frontcolor": "#2B0011",
    "marker_out_color": "#3B0001",
    "marker_in_color": "#3B0001",
    "pattern": "ellipse",
    "marker": "corner_8",
    "marker_in": "corner_in_7",
    "optionlogo": "none",
    "outer_frame": "balloon-top",
    "framelabel": "SCAN ME",
    "label_font": "Arial, Helvetica, sans-serif",
    "custom_frame_color": "on",
    "framecolor": "#3B0001"
}

Request Outcome

Gradient Mood

Extra style for socials

Request Method:

POST

Request URL:

https://createqr.app/api/v1/create

Request Parameters:

All parameters need to be sent as a JSON object in the request body.

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "data": "https://createqr.app/why-us",
    "qrtype": "dynamic",
    "title": "Brand Story QR",
    "transparent": "off",
    "backcolor": "#FFFFFF",
    "frontcolor": "#4B1EFF",
    "gradient": "on",
    "radial": "off",
    "gradient_color": "#FF7A00",
    "marker_out_color": "#101828",
    "marker_in_color": "#101828",
    "pattern": "special-diamond",
    "marker": "corner_6",
    "marker_in": "corner_in_8",
    "optionlogo": "none"
}

Request Outcome

Struttura della risposta di successo

{
    "success": true,
    "data": {
        "qrid": "1284",
        "svg": "<svg ...>...</svg>",
        "type": "dynamic",
        "title": "Launch Landing QR",
        "dashboard_url": "https://createqr.app/app/qrs/1284",
        "download_url": "https://createqr.app/app/qrs/1284/download/svg"
    },
    "request_id": "0f8fad5b-d9cb-469f-a165-70867728950e"
}

Elimina codici QR

Elimina un QR tramite ID (solo proprietario).

POST https://createqr.app/api/v1/delete

Corpo della richiesta

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "qrid": "1284"
}

Risposta

{
    "success": true,
    "data": {
        "deleted": true,
        "qrid": "1284"
    },
    "request_id": "0f8fad5b-d9cb-469f-a165-70867728950e"
}

Elenca codici QR

Elenca i tuoi QR in pagine da 100, dai più recenti.

POST https://createqr.app/api/v1/list

Usa la paginazione a partire da 1. I risultati restituiscono fino a 100 elementi per pagina.

Corpo della richiesta

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "pagination": "1"
}

Risposta

{
    "success": true,
    "data": {
        "pagination": "1",
        "page_size": 100,
        "total": 2,
        "items": [
            {
                "qrid": "1284",
                "title": "Campaign QR",
                "type": "dynamic",
                "created_at": "2026-02-17 09:12:30",
                "short_url": "https://createqr.app/r/a1b2c3",
                "dashboard_url": "https://createqr.app/app/qrs/1284"
            },
            {
                "qrid": "1269",
                "title": "Guest Wi-Fi QR",
                "type": "static",
                "created_at": "2026-02-17 08:02:08",
                "dashboard_url": "https://createqr.app/app/qrs/1269"
            }
        ]
    },
    "request_id": "0f8fad5b-d9cb-469f-a165-70867728950e"
}

Risposte di errore, limiti e tentativi

Ogni risposta include request_id. Conservalo quando contatti l'assistenza così possiamo eseguire il debug rapidamente.

Struttura tipica dell'errore

{
    "success": false,
    "error": {
        "code": "validation_error",
        "message": "Static QR is only available for WiFi payloads."
    },
    "request_id": "5f5fbd38-f82f-49ad-bf11-f7f04ca9747a"
}

Strategia di tentativi

429 rate_limited: riprova con backoff esponenziale più jitter.
Rispetta Retry-After quando presente.
429 monthly_quota_exceeded: attendi il ripristino della quota o usa una chiave con quota residua.
5xx: riprova con un numero limitato di tentativi, poi avvisa il tuo team.

Codice errore	HTTP	Quando si verifica	Cosa fare
`invalid_api_key`	401	Chiave API mancante o non valida	Fornisci una chiave valida tramite Bearer, X-API-Key o il campo nel body JSON.
`invalid_content_type`	415	Il body non è application/json	Invia Content-Type: application/json.
`request_too_large`	413	Il payload supera il limite configurato	Riduci la dimensione del body, in particolare i loghi in base64.
`plan_upgrade_required`	403	Il piano non è abilitato per l'API	Passa a Business dalla sezione Fatturazione.
`validation_error`	422	Campi non validi come URL, payload statico, colore o folderid	Usa dynamic per URL e destinazioni gestite; usa static solo per WiFi.
`rate_limited`	429	Raggiunto il limite per minuto	Riprova con backoff esponenziale e rispetta Retry-After.
`monthly_quota_exceeded`	429	Quota mensile esaurita	Attendi il ripristino o modifica le impostazioni di quota e della chiave.
`qr_not_found`	404	La destinazione di eliminazione è mancante o non ti appartiene	Verifica la proprietà di qrid e riprova.
`internal_error`	500	Problema imprevisto lato server	Riprova con backoff e conserva request_id per l'assistenza.

FAQ

Risposte brevi alle domande che vediamo più spesso nelle integrazioni.

Quante richieste API posso eseguire?

L'API è disponibile solo per Business. La quota mensile dipende dal tuo piano attivo e dalle impostazioni specifiche della chiave. La dotazione predefinita di Business è elevata e gli amministratori possono regolarla nel dettaglio per ogni chiave.

Posso inviare le chiavi API nel body JSON?

Sì. L'autenticazione tramite header è consigliata, ma sono accettati anche i campi di compatibilità nel body apikey o api_key.

Posso creare codici QR statici tramite API?

Sì, ma il modo statico è limitato a stringhe WiFi. Usa il modo dinamico per URL, PDF, menu, app, pagine social e altre destinazioni gestite.

I QR creati tramite API compaiono nella mia dashboard?

Sì. Ogni creazione andata a buon fine viene salvata nel tuo account e può essere gestita come qualsiasi altro QR.

Cosa succede quando raggiungo i limiti?

Ricevi errori JSON. Per le risposte 429, rispetta Retry-After e usa un backoff esponenziale con jitter.

Posso eliminare un QR da un altro account?

No. Le operazioni di eliminazione e visualizzazione elenco sono limitate al proprietario della chiave API autenticata.

Best practice di sicurezza

Non esporre mai chiavi API non protette nel JavaScript del browser, nei bundle mobile o nei repository pubblici.
Usa le allowlist IP delle chiavi API per limitare l'utilizzo ai server attendibili.
Registra request_id insieme ai tuoi ID di tracciamento per velocizzare la gestione degli incidenti.
Ruota le chiavi regolarmente e immediatamente dopo eventuali compromissioni delle credenziali.

Apri il gestore delle chiavi API

Automatizza la creazione di codici QR dinamici con l'API CreateQR

Guida rapida (cURL)

Autenticazione e compatibilità

Parametri principali

Parametri colore e forma

Parametri cornice

Esempi di richieste di creazione

Request Method:

Request URL:

Request Parameters:

Request Outcome

Request Method:

Request URL:

Request Parameters:

Request Outcome

Request Method:

Request URL:

Request Parameters:

Request Outcome

Request Method:

Request URL:

Request Parameters:

Request Outcome

Request Method:

Request URL:

Request Parameters:

Request Outcome

Request Method:

Request URL:

Request Parameters:

Request Outcome

Struttura della risposta di successo

Corpo della richiesta

Risposta

Corpo della richiesta

Risposta

Struttura tipica dell'errore

Strategia di tentativi

Quante richieste API posso eseguire?

Posso inviare le chiavi API nel body JSON?

Posso creare codici QR statici tramite API?

I QR creati tramite API compaiono nella mia dashboard?

Cosa succede quando raggiungo i limiti?

Posso eliminare un QR da un altro account?

Best practice di sicurezza