πŸ—‚ νŒŒμΌμ—…λ‘œλ“œ μ•ˆλ‚΄μ„œ
 1.0.1 

κ³ κ°μ‚¬μ˜ νŒŒμΌμ—…λ‘œλ“œλ₯Ό μœ„ν•œ API μš”μ²­ 및 응닡 방법을 확인할 수 μžˆλŠ” λ¬Έμ„œμž…λ‹ˆλ‹€.

CSV νŒŒμΌμ—…λ‘œλ“œ API

고객정보λ₯Ό μ—…λ‘œλ“œν•  수 μžˆμŠ΅λ‹ˆλ‹€.

POST
https://daapi.acecounter.com/api_admin/v1/upsert

κ°œμΈμ •λ³΄λ₯Ό μ‹ κ·œ 등둝 ν˜Ήμ€ κΈ°μ‘΄ κ°œμΈμ •λ³΄λ₯Ό μ—…λ°μ΄νŠΈ ν•©λ‹ˆλ‹€.

κ°œμΈμ •λ³΄ μˆ˜μ§‘ λŒ€μƒ κ³ κ°μ‚¬μ˜ 토큰을 헀더에 ν•¨κ»˜ μ‚¬μš©ν•΄μ•Ό ν•˜λ©° 토큰에 λ§€ν•‘λ˜λŠ” κ³ κ°μ‚¬μ˜ DBμ—μ„œ νšŒμ›IDλ₯Ό κΈ°μ€€μœΌλ‘œ μ‘°νšŒν•˜μ—¬ κΈ°μ‘΄ 데이터가 μžˆλŠ” 경우 μ—…λ°μ΄νŠΈ, μ‹ κ·œμΈ 경우 μƒˆλ‘œ λ“±λ‘ν•©λ‹ˆλ‹€.

νšŒμ›ID(member_id), μ „ν™”λ²ˆν˜Έ(phone)λŠ” ν•„μˆ˜ μˆ˜μ§‘ ν•„λ“œμ΄κ³  ν•„μˆ˜ μˆ˜μ§‘ ν•„λ“œλ₯Ό μ œμ™Έν•œ λͺ¨λ“  ν•„λ“œλŠ” 선택 μˆ˜μ§‘ ν•„λ“œλ‘œ μ •μ˜ν•˜λ©° ν•„λ“œμ— 값이 μ—†λŠ” κ²½μš°μ—λŠ” μ•„λž˜μ˜ κ·œμΉ™μ„ λ”°λ¦…λ‹ˆλ‹€.

  1. μˆ˜μ§‘ λŒ€μƒ ν•„λ“œμ— 값이 μ—†λŠ” κ²½μš°μ—λŠ” 곡백이 μ•„λ‹Œ ν•΄λ‹Ή ν•„λ“œ(key)λ₯Ό ν¬ν•¨ν•˜μ§€ μ•Šκ³  μš”μ²­ν•΄μ•Ό ν•©λ‹ˆλ‹€.

  2. ν•„μˆ˜ μˆ˜μ§‘ ν•„λ“œκ°€ μ—†λŠ” κ²½μš°μ—λŠ” DB에 λ°˜μ˜λ˜μ§€ μ•ŠμœΌλ©° 였λ₯˜λ₯Ό λ°˜ν™˜ν•©λ‹ˆλ‹€.

  3. 선택 μˆ˜μ§‘ ν•„λ“œκ°€ μ—†λŠ” κ²½μš°μ—λŠ” λ³„λ„μ˜ 체크 없이 μ‹ κ·œλ‘œ μˆ˜μ§‘λœ κΈ°μ€€μœΌλ‘œ 항상 μ—…λ°μ΄νŠΈ 되며 κΈ°λ³Έ κ°’ 섀정이 μžˆλŠ” ν•„λ“œμ˜ 경우 기본값이 DB에 μ €μž₯λ©λ‹ˆλ‹€.

API μš”μ²­ curl λͺ…λ Ήμ–΄ μ˜ˆμ‹œλŠ” μ•„λž˜μ™€ κ°™μŠ΅λ‹ˆλ‹€.

  • curl --location 'https://daapi.acecounter.com/api_admin/v1/upsert' --header 'Authorization: Bearer JIondONiJ9123456e1234567890I' --form 'csvfile=@"/Users/Downloads/고객정보데이터.csv"'

Header

Name Description
Authorization *
string
(Header정보)

별도 μ•ˆλ‚΄ ν•΄ λ“œλ¦° Admin Token μ‚¬μš©

Request body

Name Description
csvfile *
string
(Form정보)

μ—…λ‘œλ“œ ν•  csv파일 경둜

μ—…λ‘œλ“œ CSV νŒŒμΌμ˜ˆμ‹œλŠ” μ•„λž˜ 링크의 νšŒμ›μ •λ³΄ μ—…λ‘œλ“œ 파일 μ˜ˆμ‹œ 뢀뢄을 μ°Έμ‘°ν•΄ μ£Όμ„Έμš”.


https://daapi.acecounter.com/web/upload

Responses

Code Description
200

νŒŒμΌλ“±λ‘μ΄ μ„±κ³΅ν•œ κ²½μš°μ— λŒ€ν•œ 응닡

Media type
{
  "status": 200,
  "rows": 4,
  "message": "등둝이 μ™„λ£Œλ˜μ—ˆμŠ΅λ‹ˆλ‹€"
}
400

파일 등둝이 μ‹€νŒ¨ν•œ κ²½μš°μ— λŒ€ν•œ 응닡

Media type
{
  "status": 400,
  "detail": [
    {
      "message": "birth [1번째 쀄]",
      "type": "000000"
    }
  ]
}