CREATEQR API

Coduri QR atractive. Integrate în fluxul tău de lucru.

Creează coduri QR personalizate direct din aplicația ta. Adaugă o ramă, alege culorile brandului și gestionează fiecare cod din panoul CreateQR.

Accesul la API este inclus cât timp accesul tău la CreateQR este activ.

Cererea ta. Brandul tău.
POST /api/v1/create
200 "success": true
Calea de bază: /api/v1 Autentificare: Authorization: Bearer <key> (recomandat)

Exemple

Un singur API. Un cod QR pentru fiecare interacțiune.

Pornește de la un exemplu funcțional și personalizează-l. Explorează ramele disponibile și copiază cererea JSON corespunzătoare.

Exemplu: link minimalist personalizat

Exemplu: link minimalist personalizat

Un link cu ramă discretă, potrivit produsului tău

Vezi cererea JSON

Trimite acest JSON către POST /api/v1/create, cu cheia API în antetul 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"
}
Exemplu: QR WiFi static

Exemplu: QR WiFi static

Wi-Fi pentru oaspeți, într-o ramă inspirată de cafea

Vezi cererea JSON

Trimite acest JSON către POST /api/v1/create, cu cheia API în antetul 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"
}
Exemplu: campanie pentru magazin

Exemplu: campanie pentru magazin

O vitrină colorată pentru campaniile magazinului

Vezi cererea JSON

Trimite acest JSON către POST /api/v1/create, cu cheia API în antetul 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"
}

Exemplu: link de produs cu pictogramă

Un nor ilustrat, cu pictograma unui link în centru

Vezi cererea JSON

Trimite acest JSON către POST /api/v1/create, cu cheia API în antetul 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"
}
Exemplu: link către meniu

Exemplu: link către meniu

O ramă pentru restaurant, cu o invitație clară

Vezi cererea JSON

Trimite acest JSON către POST /api/v1/create, cu cheia API în antetul 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"
}
Exemplu: campanie pentru eveniment

Exemplu: campanie pentru eveniment

Ilustrații festive, gradient închis și colțuri jucăușe

Vezi cererea JSON

Trimite acest JSON către POST /api/v1/create, cu cheia API în antetul 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"
}

Previzualizările folosesc destinații demonstrative; codurile QR dinamice create folosesc redirecționarea gestionată pentru tine. Textul ramei poate fi modificat în cerere.

Creează coduri QR

Creezi un cod QR dinamic pentru URL-uri și destinații gestionate sau un cod QR static pentru WiFi.

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

Trimite doar JSON. Pentru autentificare, headerul este varianta recomandată. Câmpurile din body sunt păstrate pentru compatibilitate cu integrările existente.

Quickstart (cURL)

Acest exemplu de URL dinamic este cel mai rapid traseu pentru primul request funcțional.

Trimite cererile de pe serverul tău. Nu expune niciodată cheia API secretă în codul din 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"}'

Autentificare și compatibilitate

  • Recomandat: Authorization: Bearer <key>
  • Acceptat și: X-API-Key
  • Fallback JSON: apikey sau api_key
  • Content-Type trebuie să fie application/json
  • Metodele non-POST returnează 405 method_not_allowed
Envelope de răspuns cu succes
{
    "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"
}

Dă fiecărui cod QR identitatea brandului tău

Explorează modelele, colțurile, siglele și ramele acceptate. Folosește în cerere valoarea exactă afișată.

Parametri principali
Parametru Tip Implicit Descriere
apikey String Obligatoriu Cheie API secretă. Recomandat în headerul Authorization (Bearer). Sunt acceptate și câmpurile JSON apikey/api_key.
data String Obligatoriu Conținutul care va fi codificat. QR-ul dinamic necesită un URL valid. Modul static acceptă date WiFi.
qrtype String dynamic Modul static acceptă date WiFi; folosește dynamic pentru URL-uri și destinații gestionate.
title String Opțional Titlul QR-ului afișat în dashboard, limitat la 120 de caractere.
folderid Number Opțional ID numeric pozitiv al unui folder din contul tău.
Parametri de culoare și formă
Parametru Tip Implicit Descriere
transparent String/Bool off Sunt acceptate on/off, true/false, 1/0, yes/no.
backcolor String #FFFFFF Culoarea de fundal în format hex #RRGGBB.
frontcolor String #000000 Culoarea principală a modulelor QR în format #RRGGBB.
gradient String/Bool off Activează gradientul în două culori pentru puncte.
radial String/Bool off Activează gradientul radial, când gradient este pornit.
gradient_color String #15A97C A doua culoare a gradientului, în format #RRGGBB.
marker_out_color String #000000 Culoare ramă în jurul punctelor din colțuri în format #RRGGBB.
marker_in_color String #000000 Culoare puncte colțuri în format #RRGGBB.
pattern String default Preset pentru stilul punctelor QR.
Vezi opțiunile disponibile (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 Stil ramă în jurul punctelor din colțuri.
Vezi opțiunile disponibile (8)
corner_1 corner_2 corner_3 corner_4 corner_5 corner_6 corner_7 corner_8
marker_in String default Tip puncte colțuri.
Vezi opțiunile disponibile (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, cale locală recomandată către watermark SVG, cale locală legacy către PNG sau date de imagine în base64.
Vezi opțiunile disponibile (19)
no_logo_bg String/Bool on Elimină placa de fundal din spatele logo-ului.
Parametri de ramă
Parametru Tip Implicit Descriere
outer_frame String none Preset pentru stilul ramei.
Vezi opțiunile disponibile (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 Textul ramei. Ramele moderne acceptă până la 80 de caractere și 2 rânduri; depășirea limitelor returnează 422. Ramele vechi trunchiază textul la 80 de caractere.
label_font String Arial, Helvetica, sans-serif Stiva de fonturi folosită pentru textul ramei.
custom_frame_color String/Bool off Activează culoare personalizată pentru ramă.
framecolor String #000000 Culoarea ramei în format hex #RRGGBB.
label_text_color String Culoarea textului în format #RRGGBB pentru ramele moderne; omite parametrul pentru a folosi culoarea implicită a ramei.
label_size Number 0 Dimensiunea textului pentru ramele moderne: 0 ajustează automat; 10–200 reprezintă un procent din dimensiunea preferată.
label_bold Bool false Text aldin pentru ramele moderne. Folosește valoarea JSON true pentru activare.
label_italic Bool false Text cursiv pentru ramele moderne. Folosește valoarea JSON true pentru activare.

Șterge coduri QR

Ștergi un QR după ID, doar dacă îți aparține.

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

Body request

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

Răspuns

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

Listează coduri QR

Listezi QR-urile tale în pagini de 100, ordonate de la cele mai noi.

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

Folosește pagination începând de la 1. Rezultatele returnează maximum 100 de elemente pe pagină.

Body request

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

Răspuns

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

Răspunsuri de eroare, limite și retry

Fiecare răspuns include request_id. Păstrează-l când contactezi suportul, ca să putem investiga rapid.

Envelope tipic de eroare

{
    "success": false,
    "error": {
        "code": "validation_error",
        "message": "Dynamic QR requires a valid URL in data."
    },
    "request_id": "5f5fbd38-f82f-49ad-bf11-f7f04ca9747a"
}

Strategie de retry

  • 429 rate_limited: reîncearcă folosind exponential backoff plus jitter.
  • Respectă Retry-After atunci când este prezent.
  • 429 monthly_quota_exceeded: așteaptă resetarea cotei sau folosește o cheie care mai are disponibilitate.
  • 5xx: este posibil ca cererea de creare să fi reușit deja. Verifică panoul de control sau lista codurilor înainte de a reîncerca, pentru a evita duplicatele. Limitează reîncercările și păstrează request_id pentru suport.
Cod eroare HTTP Când apare Ce ai de făcut
invalid_api_key 401 Cheia API lipsește sau este invalidă Trimite o cheie validă prin Bearer, X-API-Key sau câmp JSON.
invalid_content_type 415 Body-ul nu este application/json Trimite Content-Type: application/json.
request_too_large 413 Payload-ul depășește limita configurată Redu dimensiunea body-ului, mai ales pentru logo-uri base64.
plan_upgrade_required 403 Accesul la API nu este activ pentru acest cont Verifică accesul contului și setările cheii API sau contactează suportul.
validation_error 422 Câmpuri invalide precum URL, payload static, culoare sau folderid Modul static acceptă date WiFi; folosește dynamic pentru URL-uri și destinații gestionate.
rate_limited 429 Ai atins limita pe minut Reîncearcă cu exponential backoff și respectă Retry-After.
monthly_quota_exceeded 429 Cota lunară este epuizată Așteaptă resetarea sau ajustează cota și setările cheii.
qr_not_found 404 QR-ul de șters nu există sau nu îți aparține Verifică ownership-ul pentru qrid și încearcă din nou.
internal_error 500 A apărut o problemă internă neașteptată Înainte de a retrimite o cerere de creare, verifică în panoul de control sau în listă dacă acel cod există deja. Păstrează request_id pentru suport.

FAQ

Răspunsuri scurte la întrebările pe care le vedem cel mai des în integrări.

Câte request-uri API pot rula?

Accesul la API este inclus cât timp accesul tău la CreateQR este activ. Se aplică în continuare limite de frecvență a cererilor și limite de utilizare configurate. Consultă setările cheii API sau contactează-ne înainte să planifici o integrare cu volum mare.

Pot trimite cheia API în body-ul JSON?

Da. Autentificarea prin header rămâne recomandată, dar câmpurile apikey și api_key sunt acceptate pentru compatibilitate.

Pot crea coduri QR statice prin API?

Da. Modul static acceptă date WiFi; folosește dynamic pentru URL-uri și destinații gestionate.

QR-urile create prin API apar în dashboard?

Da. Fiecare request de creare reușit este salvat în contul tău și poate fi administrat ca orice alt QR.

Ce se întâmplă când ating limitele?

Primești erori JSON. Pentru răspunsurile 429, respectă Retry-After și folosește exponential backoff cu jitter.

Pot șterge un QR din alt cont?

Nu. Operațiunile de delete și list sunt limitate la proprietarul cheii API autentificate.

Bune practici de securitate

  • Nu expune niciodată cheile API brute în JavaScript din browser, bundle-uri mobile sau repo-uri publice.
  • Folosește allowlist-uri IP pentru cheile API, ca să limitezi utilizarea la servere de încredere.
  • Înregistrează request_id împreună cu propriile trace ID-uri pentru triere mai rapidă a incidentelor.
  • Rotește cheile periodic și imediat după orice scurgere de credențiale.
Deschide managerul de chei API

CREATEQR API

Pune primul tău cod QR la treabă

Creează o cheie API secretă și conectează-ți aplicația la CreateQR.