CREATEQR API

Codici QR belli da vedere. Integrati nel tuo lavoro.

Crea codici QR con il tuo brand direttamente dal tuo software. Aggiungi una cornice, scegli i tuoi colori e gestisci ogni codice nella dashboard CreateQR.

L’accesso API è incluso quando il tuo accesso a CreateQR è attivo.

La tua richiesta. Il tuo brand.
POST /api/v1/create
200 "success": true
Percorso base: /api/v1 Autenticazione: Authorization: Bearer <key> (consigliato)

Esempi

Una sola API. Un codice QR per ogni punto di contatto.

Parti da un esempio funzionante e personalizzalo. Esplora i modelli di cornice reali e copia la richiesta JSON corrispondente.

Esempio: Link minimalista del brand

Esempio: Link minimalista del brand

Un link con una cornice pulita, in linea con il tuo prodotto

Vedi la richiesta JSON

Invia questo JSON a POST /api/v1/create con la tua chiave API nell’header Authorization.

{
    "data": "https://example.com",
    "qrtype": "dynamic",
    "title": "Launch Landing QR",
    "transparent": "off",
    "backcolor": "#FFFFFF",
    "frontcolor": "#17364D",
    "marker_out_color": "#17364D",
    "marker_in_color": "#17364D",
    "pattern": "default",
    "marker": "corner_1",
    "marker_in": "corner_in_1",
    "optionlogo": "none",
    "outer_frame": "classic_rounded_outline_v1",
    "framelabel": "EXPLORE",
    "label_font": "Arial, Helvetica, sans-serif",
    "custom_frame_color": "on",
    "framecolor": "#17364D"
}
Esempio: QR WiFi statico

Esempio: QR WiFi statico

Wi-Fi per gli ospiti con una cornice ispirata al caffè

Vedi la richiesta JSON

Invia questo JSON a POST /api/v1/create con la tua chiave API nell’header Authorization.

{
    "data": "WIFI:T:WPA;S:CreateQR Guest;P:guest-2026;H:false;;",
    "qrtype": "static",
    "title": "Guest Wi-Fi QR",
    "transparent": "off",
    "backcolor": "#FFFFFF",
    "frontcolor": "#563522",
    "marker_out_color": "#3B5545",
    "marker_in_color": "#6F3E28",
    "pattern": "circle",
    "marker": "corner_3",
    "marker_in": "corner_in_3",
    "optionlogo": "none",
    "outer_frame": "illustrated_coffee_v1",
    "framelabel": "GUEST WI-FI",
    "label_font": "Arial, Helvetica, sans-serif",
    "custom_frame_color": "on",
    "framecolor": "#70452F"
}
Esempio: Campagna per negozi

Esempio: Campagna per negozi

Una vetrina colorata per le campagne del tuo negozio

Vedi la richiesta JSON

Invia questo JSON a POST /api/v1/create con la tua chiave API nell’header Authorization.

{
    "data": "https://example.com/shop",
    "qrtype": "dynamic",
    "title": "Shop Campaign QR",
    "transparent": "off",
    "backcolor": "#FFFFFF",
    "frontcolor": "#194F57",
    "marker_out_color": "#7B3C55",
    "marker_in_color": "#254F59",
    "pattern": "special-circle-orizz",
    "marker": "corner_4",
    "marker_in": "corner_in_4",
    "optionlogo": "none",
    "outer_frame": "colorful_shopping_storefront_v1",
    "framelabel": "SHOP THE COLLECTION",
    "label_font": "Arial, Helvetica, sans-serif",
    "custom_frame_color": "on",
    "framecolor": "#175B65"
}

Esempio: Link di prodotto con icona

Una nuvola illustrata con un’icona di link al centro

Vedi la richiesta JSON

Invia questo JSON a POST /api/v1/create con la tua chiave API nell’header Authorization.

{
    "data": "https://example.com/app",
    "qrtype": "dynamic",
    "title": "Product Access QR",
    "transparent": "off",
    "backcolor": "#FFFFFF",
    "frontcolor": "#23436D",
    "marker_out_color": "#235B68",
    "marker_in_color": "#544578",
    "pattern": "ribbon",
    "marker": "corner_5",
    "marker_in": "corner_in_5",
    "optionlogo": "/images/watermarks/v2/01-link.svg",
    "outer_frame": "colorful_technology_cloud_v1",
    "framelabel": "OPEN THE APP",
    "label_font": "Arial, Helvetica, sans-serif",
    "custom_frame_color": "on",
    "framecolor": "#345A86"
}
Esempio: Link al menu

Esempio: Link al menu

Una cornice per ristoranti con un invito chiaro

Vedi la richiesta JSON

Invia questo JSON a POST /api/v1/create con la tua chiave API nell’header Authorization.

{
    "data": "https://example.com/menu",
    "qrtype": "dynamic",
    "title": "Restaurant Menu QR",
    "transparent": "off",
    "backcolor": "#FFFFFF",
    "frontcolor": "#23463B",
    "marker_out_color": "#72472B",
    "marker_in_color": "#244E42",
    "pattern": "ellipse",
    "marker": "corner_2",
    "marker_in": "corner_in_3",
    "optionlogo": "none",
    "outer_frame": "illustrated_cloche_v1",
    "framelabel": "VIEW THE MENU",
    "label_font": "Arial, Helvetica, sans-serif",
    "custom_frame_color": "on",
    "framecolor": "#245749"
}
Esempio: Campagna per eventi

Esempio: Campagna per eventi

Illustrazioni festive, sfumatura scura e angoli giocosi

Vedi la richiesta JSON

Invia questo JSON a POST /api/v1/create con la tua chiave API nell’header Authorization.

{
    "data": "https://example.com/event",
    "qrtype": "dynamic",
    "title": "Event Invitation QR",
    "transparent": "off",
    "backcolor": "#FFFFFF",
    "frontcolor": "#304878",
    "gradient": "on",
    "radial": "off",
    "gradient_color": "#783F74",
    "marker_out_color": "#245B60",
    "marker_in_color": "#773B57",
    "pattern": "circle",
    "marker": "corner_3",
    "marker_in": "corner_in_3",
    "optionlogo": "none",
    "outer_frame": "colorful_celebration_balloons_v1",
    "framelabel": "JOIN THE CELEBRATION",
    "label_font": "Arial, Helvetica, sans-serif",
    "custom_frame_color": "on",
    "framecolor": "#80558F"
}

Le anteprime usano destinazioni di esempio; i codici QR dinamici reali usano il tuo reindirizzamento gestito. Puoi modificare il testo della cornice nella richiesta.

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.

Esegui le richieste dal tuo server. Non esporre mai la chiave API segreta nel codice del browser.

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
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"
}

Dai a ogni codice QR l’identità del tuo brand

Esplora i motivi, gli angoli, i loghi e le cornici supportati. Usa nella richiesta il valore esatto mostrato.

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. La modalità statica supporta i dati WiFi.
qrtype String dynamic La modalità static supporta i dati WiFi; usa dynamic per URL e destinazioni gestite.
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 nel formato #RRGGBB.
marker_in_color String #000000 Colore dei punti angolari nel formato #RRGGBB.
pattern String default Preset di stile dei punti del corpo.
Esplora le opzioni disponibili (19)
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.
Esplora le opzioni disponibili (8)
corner_1 corner_2 corner_3 corner_4 corner_5 corner_6 corner_7 corner_8
marker_in String default Tipo dei punti angolari.
Esplora le opzioni disponibili (8)
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.
Esplora le opzioni disponibili (19)
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.
Esplora le opzioni disponibili (211)
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 Testo della cornice. Le cornici moderne accettano fino a 80 caratteri e 2 righe; superare questi limiti restituisce 422. Le cornici precedenti troncano il testo 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.
label_text_color String Colore del testo in #RRGGBB per le cornici moderne; ometti il campo per usare il colore predefinito della cornice.
label_size Number 0 Dimensione del testo per le cornici moderne: 0 si adatta automaticamente; 10–200 imposta una percentuale della dimensione preferita.
label_bold Bool false Testo in grassetto per le cornici moderne. Usa il valore JSON true per attivarlo.
label_italic Bool false Testo in corsivo per le cornici moderne. Usa il valore JSON true per attivarlo.

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": "Dynamic QR requires a valid URL in data."
    },
    "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: una richiesta di creazione potrebbe essere già riuscita. Controlla la dashboard o l’elenco dei codici prima di riprovare, per evitare duplicati. Limita i tentativi e conserva request_id per l’assistenza.
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 L’accesso API non è attivo per questo account Controlla l’accesso dell’account e le impostazioni della chiave API, oppure contatta l’assistenza.
validation_error 422 Campi non validi come URL, payload statico, colore o folderid La modalità static supporta i dati WiFi; usa dynamic per URL e destinazioni gestite.
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 Prima di ripetere una richiesta di creazione, verifica nella dashboard o nell’elenco se il codice esiste già. Conserva request_id per l’assistenza.

FAQ

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

Quante richieste API posso eseguire?

L’accesso API è incluso quando il tuo accesso a CreateQR è attivo. Restano applicabili i limiti di frequenza e i limiti di utilizzo configurati. Controlla le impostazioni della chiave API o contattaci prima di pianificare un’integrazione ad alto volume.

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ì. La modalità static supporta i dati WiFi; usa dynamic per URL e 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

CREATEQR API

Metti al lavoro il tuo primo codice QR

Crea una chiave API segreta e collega la tua applicazione a CreateQR.