API Introduction

{
  "error": "Too many requests. Please try again later."
}

{
  "error": "Rate limit reached. Try again in 45 minutes."
}

{
  "status": "success",
  "data": {
    // Response data here
  }
}

{
  "error": "Error message description"
}

curl -X POST https://api.gitachat.org/api/query \
  -H "Content-Type: application/json" \
  -d '{"query": "How do I overcome fear and anxiety?"}'

{
  "status": "success",
  "data": {
    "chapter": 2,
    "verse": 47,
    "translation": "You have a right to perform your prescribed duty, but you are not entitled to the fruits of action...",
    "summarized_commentary": "This verse addresses anxiety by teaching detachment from outcomes...",
    "full_commentary": "Traditional commentary explaining the verse in detail..."
  }
}

curl -X POST https://api.gitachat.org/api/verse \
  -H "Content-Type: application/json" \
  -d '{"chapter": 2, "verse": 47}'

curl https://api.gitachat.org/api/all-verses

{
  "status": "success",
  "data": [
    {
      "chapter": 1,
      "verse": 1,
      "translation": "Dhritarashtra said: O Sanjaya...",
      "summary": "Brief summary (max 500 chars)"
    },
    // ... 702 more verses
  ]
}

curl https://gitachat.org/api/bookmarks \
  -H "Authorization: Bearer YOUR_CLERK_TOKEN"

[
  {
    "id": "uuid",
    "user_id": "user_xxx",
    "chapter": 2,
    "verse": 47,
    "translation": "You have a right to perform...",
    "summarized_commentary": "This verse teaches...",
    "created_at": "2024-01-15T10:30:00Z"
  }
]

curl -X DELETE "https://gitachat.org/api/bookmarks?chapter=2&verse=47" \
  -H "Authorization: Bearer YOUR_CLERK_TOKEN"

[
  {
    "id": "uuid",
    "user_id": "user_xxx",
    "query": "How to overcome fear?",
    "chapter": 2,
    "verse": 47,
    "translation": "...",
    "summarized_commentary": "...",
    "created_at": "2024-01-15T10:30:00Z"
  }
]

{
  "chapter": 3,
  "verse": 21,
  "translation": "Whatever action a great man performs...",
  "summarized_commentary": "...",
  "cached": false
}

{
  "subscribed": true,
  "timezone": "America/New_York"
}

{
  "imageUrl": "https://storage.example.com/verse-images/2-47-hash.webp",
  "shareUrl": "https://gitachat.org/image/uuid",
  "cached": false
}

{
  "exists": true,
  "imageUrl": "...",
  "shareUrl": "..."
}

{
  "status": "ok"
}