API λ¬Έμ„œ

SmartCal AI APIλ₯Ό μ‚¬μš©ν•˜μ—¬ μŒμ‹ 인식 및 μ˜μ–‘ 뢄석 κΈ°λŠ₯을 μ—¬λŸ¬λΆ„μ˜ 앱에 ν†΅ν•©ν•˜μ„Έμš”.

⚠️ API 이용 μ•ˆλ‚΄: APIλŠ” Pro ν”Œλžœ κ΅¬λ…μžμ—κ²Œλ§Œ μ œκ³΅λ©λ‹ˆλ‹€. μžμ„Έν•œ λ‚΄μš©μ€ μš”κΈˆμ œλ₯Ό ν™•μΈν•˜μ„Έμš”.

πŸ” 인증

λͺ¨λ“  API μš”μ²­μ—λŠ” Bearer 토큰이 ν•„μš”ν•©λ‹ˆλ‹€.

Authorization: Bearer YOUR_ACCESS_TOKEN

πŸ“ Base URL

https://api.smartcal-ai.com/v1

πŸ” μŒμ‹ 뢄석

POST/analyze

이미지λ₯Ό μ—…λ‘œλ“œν•˜μ—¬ μŒμ‹μ„ λΆ„μ„ν•©λ‹ˆλ‹€.

Request

νŒŒλΌλ―Έν„° νƒ€μž… μ„€λͺ…
image *ν•„μˆ˜ binary 뢄석할 μŒμ‹ 이미지 (JPEG, PNG)
detail_level string 뢄석 상세도 (basic, detailed, full)

Response

{
  "success": true,
  "data": {
    "foods": [
      {
        "name": "λΉ„λΉ”λ°₯",
        "confidence": 0.95,
        "calories": 520,
        "nutrition": {
          "carbs": 85,
          "protein": 18,
          "fat": 12,
          "sodium": 890
        }
      }
    ],
    "total_calories": 520
  }
}

πŸ“Š 식단 기둝

GET/meals

μ‚¬μš©μžμ˜ 식단 기둝을 μ‘°νšŒν•©λ‹ˆλ‹€.

νŒŒλΌλ―Έν„° νƒ€μž… μ„€λͺ…
start_date string μ‹œμž‘ λ‚ μ§œ (YYYY-MM-DD)
end_date string μ’…λ£Œ λ‚ μ§œ (YYYY-MM-DD)
limit integer κ²°κ³Ό 수 μ œν•œ (κΈ°λ³Έ: 20, μ΅œλŒ€: 100)

POST/meals

μƒˆλ‘œμš΄ 식단을 κΈ°λ‘ν•©λ‹ˆλ‹€.

πŸ‘€ μ‚¬μš©μž

GET/user/me

ν˜„μž¬ λ‘œκ·ΈμΈν•œ μ‚¬μš©μž 정보λ₯Ό μ‘°νšŒν•©λ‹ˆλ‹€.

GET/user/stats

μ‚¬μš©μžμ˜ μ„­μ·¨ 톡계λ₯Ό μ‘°νšŒν•©λ‹ˆλ‹€.

⚠️ μ—λŸ¬ μ½”λ“œ

μ½”λ“œ μ„€λͺ…
400 잘λͺ»λœ μš”μ²­
401 인증 μ‹€νŒ¨
403 κΆŒν•œ μ—†μŒ (Pro ν”Œλžœ ν•„μš”)
404 λ¦¬μ†ŒμŠ€λ₯Ό 찾을 수 μ—†μŒ
429 μš”μ²­ ν•œλ„ 초과
500 μ„œλ²„ 였λ₯˜

πŸ“ž 지원

API κ΄€λ ¨ 문의: api@smartcal-ai.com