🎉 Nové bezplatné API pro generování vašich QR kódů

Skvělá zpráva! Poskytuji bezplatné API, které vám umožňuje generovat vaše vlastní QR kódy (text, odkaz nebo platbu SEPA).
Jednoduché na použití, funguje přímo z vašeho prohlížeče nebo aplikací, s limitem 5 QR kódů denně na uživatele.

📌 Proč API QR kód? 

QR kódy se staly nezbytnými:

• Přidat odkaz na vaši stránku
• Sdílet vaše kontaktní údaje
• Obdržet okamžitou bankovní platbu (SEPA v Belgii/Francii/Evropě)
• A nebo jednoduše zakódovat malý text.

Naše API vám to umožňuje bez složité registrace, s rozumným limitem, aby se předešlo zneužití.

🔑 Vaše uživatelské ID

Pro použití API se musíte přihlásit do svého účtu Digital3D, tam najdete svůj klíč.

• Přejděte do svého profilu,
• Kopírujte své uživatelské ID (UUID), dlouhý řetězec znaků jako:

⚠️ Toto uživatelské ID je povinné. Bez něj API neodpoví.

📍 Dva dostupné koncové body

1. QR kód text / odkaz

Zakódujte libovolný text nebo URL do QR kódu.
👉 Příklad pro zobrazení "Hello World":
    GET https://qr.digital3d.com/api/QrCreator/NormalQr?userId=VAŠE_UŽIVATELSKÉID&text=Hello%20World&format=Png&size=6

• userId → vaše identifikační číslo (povinné)
• text → obsah k zakódování
• format → Png nebo Svg (volitelné, výchozí = Png)
• size → velikost QR (1–20, výchozí = 4)

➡️ Výsledkem je přímo obrázek (image/png nebo image/svg+xml).

2. QR kód pro platbu SEPA (EPC QR)

Vytvořte QR, který vaši přátelé nebo klienti mohou naskenovat ve své bankovní aplikaci, aby vám zaplatili.
👉 Příklad JSON :
      POST https://qr.digital3d.com/api/QrCreator/PaymentQr Content-Type: application/json { "userId": "VAŠE_UŽIVATELSKÉID", "beneficiaryName": "ACME SPRL", "iban": "BE68539007547034", "bic": "GKCCBEBB", "amount": 12.34, "remittance": "Faktura 2025-001", "outputFormat": "Svg", "size": 8 }

➡️ Výsledkem je také obrázek QR kódu.

🚦 Limity a chyby

Každý uživatel může vytvořit maximálně 5 QR kódů denně.
Pokud překročíte, API vrátí jasnou JSON chybu:

{"type":"https://httpstatuses.com/429","title":"Překročen limit","status":429,"detail":"Maximální použití pro dnešek: 5 (limit 5)","userId":"abscdef-5555-ffff-yyyy-xxxxxxx","used":5,"limit":5}

🛠️ Pro začátečníky

• Testujte přímo ve svém prohlížeči s koncovým bodem NormalQr.
• Pro platbu (koncový bod PaymentQr) použijte nástroj jako Postman nebo svůj oblíbený programovací jazyk (C#, Python, JavaScript…).
• Není potřeba žádná složitá knihovna: API již vrací obrázek připravený k použití.

✅ Shrnutí

• Bezplatné: 5 QR kódů denně na uživatele.
• Snadné: jednoduché volání GET nebo POST.
• Kompletní: podpora textu, odkazů a platby SEPA.

👉 Navštivte https://qr.digital3d.com/swagger, abyste prozkoumali API podrobně a otestovali své vlastní volání.