π μ λΆλ°μ΄ν° νμ€νλ 무μμΈκ°μ?
μ λΆλ°μ΄ν° νμ€νλ λ―Όκ°μ νμ©μμλ₯Ό κ³ λ €νμ¬ κ³΅κ³΅λ°μ΄ν°ν¬νΈμ κ°λ°©λ°μ΄ν°λ₯Ό λμΌν νλͺ©κ³Ό νμμΌλ‘ μ 곡ν μ μλλ‘ νμ μμ λΆμ₯κ΄μ΄ μ ν κ°λ°©λ°μ΄ν° νμ€μ μλ―Έν΄μ. μ΄λ₯Ό ν΅ν΄ μλ‘ λ€λ₯Έ μ λΆκΈ°κ΄μ λ°μ΄ν°λ μΌκ΄λ νμμΌλ‘ νμ©ν μ μκ² λ©λλ€.

νμ¬ κ³΅κ³΅λ°μ΄ν°ν¬νΈμμλ 3λ¨κ³ μ΄μμ μ€ν ν¬λ§· νμΌλ°μ΄ν°λ₯Ό μ€ν API(RestAPI κΈ°λ°μ JSON/XML)λ‘ μλλ³ννμ¬ μ 곡νκ³ μμ΄μ. μ΄λ λ°μ΄ν° νΈνμ±μ ν¬κ² λμ¬μ£Όλ μ€μν μμ€ν μ λλ€.
π‘ νμ€λ°μ΄ν°μ νμΈνλ λ°©λ²
μ 곡νμ€ λ°μ΄ν°μ μ 보μ νκ³ μλ 곡곡기κ΄μ νμ μμ λΆμ₯κ΄μ΄ μ μν ‘κ³΅κ³΅λ°μ΄ν° μ 곡 νμ€’μ μ€μνμ¬ νμΌλ°μ΄ν° λλ μ€ν API λ°©μμΌλ‘ λ°μ΄ν°μ μ μμ±νκ³ μ 곡ν΄μΌ ν΄μ.
κ°λ³κΈ°κ΄μ΄ λ±λ‘ν μ 곡νμ€ λ°μ΄ν°μ μ 곡곡λ°μ΄ν°ν¬νΈμ “λ°μ΄ν° μ°ΎκΈ° > λ°μ΄ν° λͺ©λ‘ > νμ€λ°μ΄ν°μ ” λ©λ΄μμ νμΈν μ μμ΅λλ€. νμ¬ κΈ°μ€μ 곡곡λ°μ΄ν° μ 곡 νμ€ 20μ°¨ μ Β·κ°μ (2025λ 10μ)μ λ°λ₯΄κ³ μμ΄μ.
π λ°μ΄ν° νλͺ© κ΅¬μ± λ° νμ
νμ€νλ λ°μ΄ν°μ μ κ° νλͺ©μ νλͺ©λͺ , μλ¬Έλͺ , νλͺ© μ€λͺ , λλ©μΈλΆλ₯, λ°μ΄ν°νμ , μ΅λκΈΈμ΄, ννλ°©μ, λ¨μ, μμ±μΆμ², μ½λλ‘ κ΅¬μ±λμ΄ μμ΄μ. λ°μ΄ν°νμ μ μ¬μ© λͺ©μ μ λ°λΌ μ¬λ¬ μ’ λ₯λ‘ λΆλ₯λμ΄ μμ΅λλ€.
| λ°μ΄ν°νμ | μ΅λκΈΈμ΄ μμ | μ©λ |
|---|---|---|
| μ«μν(NUMERIC) | 22 | κΈμ‘, μλ, ν΅κ³ λ± μμΉ λ°μ΄ν° |
| κ°λ³λ¬Έμν(VARCHAR) | 100, 1000, 4000, 200, 50, 10 | μ΄λ¦, μ€λͺ , μ£Όμ λ± κ°λ³ κΈΈμ΄ ν μ€νΈ |
| κ³ μ λ¬Έμν(CHAR) | 1, 500, 6560 | μ½λ, λΆλ₯κ° λ± κ³ μ κΈΈμ΄ ν μ€νΈ |
π μ€ν API νμ©νκΈ°
곡곡λ°μ΄ν°νμ©μ§μμΌν°λ 곡곡λ°μ΄ν°ν¬νΈμ κ°λ°©λλ 3λ¨κ³ μ΄μμ μ€ν ν¬λ§· νμΌλ°μ΄ν°λ₯Ό μ€ν API(RestAPI κΈ°λ°μ JSON/XML)λ‘ μλλ³ννμ¬ μ 곡νκ³ μμ΄μ. μ€ν APIλ₯Ό νμ©νλ €λ©΄ 곡곡λ°μ΄ν°ν¬νΈ νμ κ°μ λ° νμ©μ μ²μ΄ νμμ λλ€.
μΉκΈ°λ° μ€ν API νμ© λͺ μΈμμΈ Swagger UIλ λ§μ΄ν¬λ‘μννΈ μ£μ§, ν¬λ‘¬, μ¬ν리, λ€μ΄λ² μ¨μΌ λ± μ£Όμ λΈλΌμ°μ μμ νμΈν μ μμ΄μ. API νΈμΆ μ λ°μνλ λ€μν μλ¬μ½λλ₯Ό μ νν μ΄ν΄νλ©΄ λ¬Έμ ν΄κ²°μ΄ μμν©λλ€.
β οΈ μ£Όμ μ€ν API μλ¬μ½λμ λμ λ°©λ²
μ€ν API νΈμΆ μ μ¬λ¬ μλ¬κ° λ°μν μ μμ΄μ. κ° μλ¬μ½λλ³λ‘ μμΈκ³Ό ν΄κ²° λ°©λ²μ μμλλ©΄ κ°λ° κ³Όμ μμ ν° λμμ΄ λ©λλ€.
| μλ¬νμ | μλ¬μ½λ | λμ λ°©λ² |
|---|---|---|
| APPLICATION_ERROR | 01 | μ μ ν λ€μ νΈμΆνκ³ , λ¬Έμ κ° λ°λ³΅λλ©΄ νμ©μ§μμΌν°μ λ¬Έμ |
| APPLICATION_ERROR | 04 | μμ² λ°©μκ³Ό νΈμΆ URL νμΈ |
| SERVICETIMEOUT_ERROR | 05 | μ°κ²° μ€ν¨ λλ μλ΅ λκΈ°μκ° μ΄κ³Ό – μ μ ν μ¬νΈμΆ |
| SERVICE_KEY_IS_NULL | 20 | 곡곡λ°μ΄ν°ν¬νΈμμ λ°κΈλ°μ μΈμ¦ν€λ₯Ό μμ² νλΌλ―Έν°μ ν¬ν¨ |
| LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR | – | μΌμΌ νΈμΆ νμ©λ μ΄κ³Ό – νΈμΆλ μ΄κΈ°ν ν μ¬μ΄μ© λλ νΈλν½ μ¦μ€ μ μ² |
| BLACKLIST_IP_ACCESS_ERROR | 29 | νΈμΆ μλ²μ IP νμΈ ν νμμ νμ©μ§μμΌν°μ μ°¨λ¨ ν΄μ μμ² |
β νΈνμ± νμΈ μ μ£Όμμ¬ν
- νμ λ° μ ν μ λ ₯κ° νμΈ: μ 곡νμ€ μ 보 μ μ λ° κ΄λ¦¬μ νΉμ±μ νλͺ©λ³ νμ μ λ ₯κ°κ³Ό μ ν μ λ ₯κ°μ΄ ꡬλΆλμ΄ μμ΄μ. μ ν μ λ ₯κ°μ λΉ κ°μ΄ μ‘΄μ¬ν μ μμ΅λλ€.
- νμΌλ°μ΄ν° λ€μ΄λ‘λ: νμΌλ°μ΄ν°λ λ‘κ·ΈμΈ μμ΄ λ€μ΄λ‘λλ₯Ό ν΅ν΄ μ΄μ©ν μ μμ΄μ. μ΄λ₯Ό νμ©νλ©΄ λ³λμ API μΉμΈ μ μ°¨ μμ΄ λ°μ΄ν°μ μ κ·Όν μ μμ΅λλ€.
- λ°μ΄ν° μ€λ₯ μ κ³ : λ°μ΄ν° μ€λ₯λ κ°μ μκ²¬μ΄ μμΌλ©΄ 곡곡λ°μ΄ν°ν¬νΈ μ ν(1566-0025)λ‘ μ κ³ ν μ μμ΄μ.
- νμ©μ μ² νμ: μ€ν APIλ₯Ό νμ©νλ €λ©΄ λ°λμ 곡곡λ°μ΄ν°ν¬νΈμμ νμ©μ μ²μ μλ£ν΄μΌ ν΄μ. κΈ°μ μ λ¬Έμλ 곡곡λ°μ΄ν°νμ©μ§μμΌν°λ‘ μ°λ½νλ©΄ λ©λλ€.
π― μμ£Ό 묻λ μ§λ¬Έ
Q. νμ€λ°μ΄ν°μ
κ³Ό μΌλ° λ°μ΄ν°μ
μ μ°¨μ΄μ μ λκ°μ?
νμ€λ°μ΄ν°μ
μ νμ μμ λΆμ₯κ΄μ΄ μ μν 곡곡λ°μ΄ν° μ 곡 νμ€μ μ€μνμ¬ λμΌν νλͺ©κ³Ό νμμΌλ‘ μ 곡λλ λ°μ΄ν°λ₯Ό λ§ν΄μ. μ΄λ κ² νμ€νλλ©΄ μ¬λ¬ κΈ°κ΄μ λ°μ΄ν°λ₯Ό μΌκ΄λ λ°©μμΌλ‘ νμ©ν μ μμ΅λλ€.
Q. API μΈμ¦ν€λ μΈμ λ§λ£λλμ?
API μΈμ¦ν€λ μ¬μ© κΈ°νμ΄ μ ν΄μ Έ μμ΄μ. κΈ°νμ΄ λ§λ£λλ©΄ 곡곡λ°μ΄ν°ν¬νΈμμ μ΄μ© κΈ°κ°μ νμΈνκ±°λ κ°±μ ν΄μΌ ν©λλ€.
Q. λ°μ΄ν° μ체μ λ¬Έμ κ° μμ λλ λꡬμκ² μ°λ½ν΄μΌ νλμ?
λ°μ΄ν° μ체μ λν λ¬Έμλ ν΄λΉ μ 곡기κ΄μ κ΄λ¦¬λΆμ μ νλ²νΈλ‘ μ§μ μ°λ½ν΄μΌ ν΄μ. μ€ν API νμ© κ΄λ ¨ λ¬Έμλ 곡곡λ°μ΄ν°νμ©μ§μμΌν°λ‘ νλ©΄ λ©λλ€.
π μ°Έκ³ μλ£
μ λΆλ°μ΄ν°μ νμ€νλ κ°λ°μμ λ°μ΄ν° νμ©μ λͺ¨λμκ² λ λμ κ²½νμ μ 곡ν΄μ. νμ€μ μ΄ν΄νκ³ μ¬λ°λ₯΄κ² νμ©νλ©΄ λ°μ΄ν° κΈ°λ° μλΉμ€λ₯Ό λμ± ν¨μ¨μ μΌλ‘ κ°λ°ν μ μμ΅λλ€. νΉμ νΈνμ± λ¬Έμ κ° λ°μνλ©΄ 곡μ μ±λμ λ¬Έμνμ¬ λΉ λ₯΄κ² ν΄κ²°ν΄ 보μΈμ!
λ΅κΈ λ¨κΈ°κΈ°