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