π μλ‘μ΄ λ¬΄λ£ 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λ₯Ό μμΈν νμνκ³ μμ μ νΈμΆμ ν μ€νΈνμΈμ.
Join the conversation
You need an account to comment on this article. Creating one is free and takes under a minute.
No comments yet.