๐ ์๋ก์ด ๋ฌด๋ฃ 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→ ์ธ์ฝ๋ฉํ ๋ด์ฉformat→Png๋๋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.