무료 QR 코드 생성 및 결제 QR 코드 생성 API

๐ŸŽ‰ ์ƒˆ๋กœ์šด ๋ฌด๋ฃŒ API๋กœ QR ์ฝ”๋“œ๋ฅผ ์ƒ์„ฑํ•˜์„ธ์š”

์ข‹์€ ์†Œ์‹์ž…๋‹ˆ๋‹ค! ์—ฌ๋Ÿฌ๋ถ„์ด ์ง์ ‘ QR ์ฝ”๋“œ๋ฅผ ์ƒ์„ฑํ•  ์ˆ˜ ์žˆ๋Š” ๋ฌด๋ฃŒ API๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค (ํ…์ŠคํŠธ, ๋งํฌ ๋˜๋Š” SEPA ๊ฒฐ์ œ).
์‚ฌ์šฉํ•˜๊ธฐ ๊ฐ„ํŽธํ•˜๋ฉฐ, ๋ธŒ๋ผ์šฐ์ €๋‚˜ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์—์„œ ์ง์ ‘ ์ž‘๋™ํ•˜๋ฉฐ, ์‚ฌ์šฉ์ž๋‹น ํ•˜๋ฃจ 5๊ฐœ์˜ QR ์ฝ”๋“œ๋กœ ์ œํ•œ๋ฉ๋‹ˆ๋‹ค.


๐Ÿ“Œ QR ์ฝ”๋“œ API๊ฐ€ ํ•„์š”ํ•œ ์ด์œ ๋Š”? 

QR ์ฝ”๋“œ๋Š” ํ•„์ˆ˜์ ์ด ๋˜์—ˆ์Šต๋‹ˆ๋‹ค:

  • ๊ท€ํ•˜์˜ ์‚ฌ์ดํŠธ๋กœ์˜ ๋งํฌ ์ถ”๊ฐ€
  • ์—ฐ๋ฝ์ฒ˜ ๊ณต์œ 
  • ์ฆ‰์‹œ ์€ํ–‰ ๊ฒฐ์ œ ์ˆ˜๋ น (๋ฒจ๊ธฐ์—/ํ”„๋ž‘์Šค/์œ ๋Ÿฝ์˜ SEPA)
  • ์•„๋‹ˆ๋ฉด ๊ฐ„๋‹จํ•œ ํ…์ŠคํŠธ ์ธ์ฝ”๋”ฉ.

์ €ํฌ API๋Š” ๋ณต์žกํ•œ ๋“ฑ๋ก ์—†์ด ์ด๋ฅผ ๊ฐ€๋Šฅํ•˜๊ฒŒ ํ•˜๋ฉฐ, ๋‚จ์šฉ์„ ๋ฐฉ์ง€ํ•˜๊ธฐ ์œ„ํ•œ ํ•ฉ๋ฆฌ์ ์ธ ํ• ๋‹น๋Ÿ‰์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.


๐Ÿ”‘ ์‚ฌ์šฉ์ž ID

API๋ฅผ ์‚ฌ์šฉํ•˜๋ ค๋ฉด Digital3D ๊ณ„์ •์— ๋กœ๊ทธ์ธํ•ด์•ผ ํ•˜๋ฉฐ, ๊ฑฐ๊ธฐ์„œ ํ‚ค๋ฅผ ์ฐพ์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

  • ํ”„๋กœํ•„๋กœ ์ด๋™ํ•˜์„ธ์š”,
  • User ID (UUID)๋ฅผ ๋ณต์‚ฌํ•˜์„ธ์š”, ๊ธด ๋ฌธ์ž์—ด ํ˜•์‹์ž…๋‹ˆ๋‹ค:

โš ๏ธ ์ด ์‚ฌ์šฉ์ž ID๋Š” ํ•„์ˆ˜์ž…๋‹ˆ๋‹ค. ์—†์œผ๋ฉด API๊ฐ€ ์‘๋‹ตํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.


๐Ÿ“ ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ๋‘ ๊ฐœ์˜ ์—”๋“œํฌ์ธํŠธ

1. ํ…์ŠคํŠธ/๋งํฌ QR ์ฝ”๋“œ

์–ด๋–ค ํ…์ŠคํŠธ๋‚˜ URL์„ QR ์ฝ”๋“œ๋กœ ์ธ์ฝ”๋”ฉํ•˜์„ธ์š”.
๐Ÿ‘‰ "Hello World"๋ฅผ ํ‘œ์‹œํ•˜๋Š” ์˜ˆ:
    GET https://qr.digital3d.com/api/QrCreator/NormalQr?userId=๊ท€ํ•˜์˜_USERID&text=Hello%20World&format=Png&size=6

  • userId → ๊ท€ํ•˜์˜ ์•„์ด๋”” (ํ•„์ˆ˜)
  • text → ์ธ์ฝ”๋”ฉํ•  ๋‚ด์šฉ
  • formatPng ๋˜๋Š” Svg (์„ ํƒ ์‚ฌํ•ญ, ๊ธฐ๋ณธ๊ฐ’ = Png)
  • size → QR ํฌ๊ธฐ (1–20, ๊ธฐ๋ณธ๊ฐ’ = 4)

โžก๏ธ ๊ฒฐ๊ณผ๋Š” ๋ฐ”๋กœ ์ด๋ฏธ์ง€์ž…๋‹ˆ๋‹ค (image/png ๋˜๋Š” image/svg+xml).


2. SEPA ๊ฒฐ์ œ QR ์ฝ”๋“œ (EPC QR)

์นœ๊ตฌ๋‚˜ ๊ณ ๊ฐ์ด ์€ํ–‰ ์•ฑ์—์„œ ์Šค์บ”ํ•˜์—ฌ ๊ฒฐ์ œํ•  ์ˆ˜ ์žˆ๋Š” QR ์ฝ”๋“œ๋ฅผ ์ƒ์„ฑํ•˜์„ธ์š”.
๐Ÿ‘‰ JSON ์˜ˆ์‹œ:
      POST https://qr.digital3d.com/api/QrCreator/PaymentQr Content-Type: application/json { "userId": "๊ท€ํ•˜์˜_USERID", "beneficiaryName": "ACME SPRL", "iban": "BE68539007547034", "bic": "GKCCBEBB", "amount": 12.34, "remittance": "์ฒญ๊ตฌ์„œ 2025-001", "outputFormat": "Svg", "size": 8 }

โžก๏ธ ๊ฒฐ๊ณผ๋Š” ๋˜ํ•œ QR ์ฝ”๋“œ ์ด๋ฏธ์ง€์ž…๋‹ˆ๋‹ค.


๐Ÿšฆ ํ• ๋‹น๋Ÿ‰ ๋ฐ ์˜ค๋ฅ˜

๊ฐ ์‚ฌ์šฉ์ž๋Š” ํ•˜๋ฃจ ์ตœ๋Œ€ 5๊ฐœ์˜ QR ์ฝ”๋“œ๋ฅผ ์ƒ์„ฑํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
์ดˆ๊ณผ ์‹œ, API๋Š” ๋ช…ํ™•ํ•œ JSON ์˜ค๋ฅ˜๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค:

{"type":"https://httpstatuses.com/429","title":"ํ• ๋‹น๋Ÿ‰ ์ดˆ๊ณผ","status":429,"detail":"์˜ค๋Š˜์˜ ์ตœ๋Œ€ ์‚ฌ์šฉ๋Ÿ‰: 5 (์ œํ•œ 5)","userId":"abscdef-5555-ffff-yyyy-xxxxxxx","used":5,"limit":5}


๐Ÿ› ๏ธ ์ดˆ๋ณด์ž๋ฅผ ์œ„ํ•œ

  • ์—”๋“œํฌ์ธํŠธ NormalQr๋กœ ๋ธŒ๋ผ์šฐ์ €์—์„œ ์ง์ ‘ ํ…Œ์ŠคํŠธํ•˜์„ธ์š”.
  • ๊ฒฐ์ œ๋ฅผ ์œ„ํ•ด (์—”๋“œํฌ์ธํŠธ PaymentQr), Postman๊ณผ ๊ฐ™์€ ๋„๊ตฌ๋ฅผ ์‚ฌ์šฉํ•˜๊ฑฐ๋‚˜ ์„ ํ˜ธํ•˜๋Š” ํ”„๋กœ๊ทธ๋ž˜๋ฐ ์–ธ์–ด(C#, Python, JavaScript ๋“ฑ)๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.
  • ๋ณต์žกํ•œ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ํ•„์š” ์—†์Œ: API๋Š” ์ด๋ฏธ ์‚ฌ์šฉ ์ค€๋น„๊ฐ€ ๋œ ์ด๋ฏธ์ง€๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

โœ… ์š”์•ฝ

  • ๋ฌด๋ฃŒ: ์‚ฌ์šฉ์ž๋‹น ํ•˜๋ฃจ 5๊ฐœ์˜ QR ์ฝ”๋“œ.
  • ์‰ฌ์›€: ๊ฐ„๋‹จํ•œ GET ๋˜๋Š” POST ํ˜ธ์ถœ.
  • ์™„์ „ํ•จ: ํ…์ŠคํŠธ, ๋งํฌ ๋ฐ SEPA ๊ฒฐ์ œ ์ง€์›.

๐Ÿ‘‰ https://qr.digital3d.com/swagger์—์„œ API๋ฅผ ์ž์„ธํžˆ ํƒ์ƒ‰ํ•˜๊ณ  ์ž์‹ ์˜ ํ˜ธ์ถœ์„ ํ…Œ์ŠคํŠธํ•˜์„ธ์š”.

Aucun commentaire pour le moment.

Une erreur s'est produite. Cette application peut ne plus rรฉpondre jusqu'ร  ce qu'elle soit rechargรฉe.Veuillez contacter l'auteur. Reload ๐Ÿ—™