API Specifications

Authorization: Bearer <jwt_token>

POST /auth/login
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "password"
}

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 3600
}

GET /api/v1/users/{id}
Authorization: Bearer {token}

PUT /api/v1/users/{id}
Authorization: Bearer {token}
Content-Type: application/json

{
  "first_name": "John",
  "last_name": "Doe",
  "bio": "Learning enthusiast"
}

GET /api/v1/users?role=student&limit=20&offset=0
Authorization: Bearer {token}

GET /api/v1/courses?category=programming&level=beginner&limit=10

GET /api/v1/courses/{id}

POST /api/v1/courses
Authorization: Bearer {token}
Content-Type: application/json

{
  "title": "Introduction to React",
  "description": "Learn React fundamentals",
  "category_id": "uuid",
  "price": 49.99,
  "level": "beginner"
}

PUT /api/v1/courses/{id}
Authorization: Bearer {token}
Content-Type: application/json

{
  "title": "Advanced React",
  "is_published": true
}

DELETE /api/v1/courses/{id}
Authorization: Bearer {token}

POST /api/v1/enrollments
Authorization: Bearer {token}
Content-Type: application/json

{
  "course_id": "uuid"
}

GET /api/v1/enrollments/{id}/progress
Authorization: Bearer {token}

PUT /api/v1/enrollments/{enrollment_id}/lessons/{lesson_id}/progress
Authorization: Bearer {token}
Content-Type: application/json

{
  "completed": true,
  "time_spent_minutes": 45
}

POST /api/v1/payments/intent
Authorization: Bearer {token}
Content-Type: application/json

{
  "amount": 49.99,
  "currency": "USD",
  "description": "Course enrollment"
}

POST /api/v1/payments/{id}/process
Authorization: Bearer {token}
Content-Type: application/json

{
  "payment_method_id": "pm_1234567890"
}

GET /api/v1/payments?status=completed&limit=20
Authorization: Bearer {token}

GET /api/v1/consultations?category=programming&available=true

POST /api/v1/consultations/{id}/book
Authorization: Bearer {token}
Content-Type: application/json

{
  "scheduled_at": "2024-01-15T14:00:00Z"
}

GET /api/v1/consultations/{id}
Authorization: Bearer {token}

GET /api/v1/search/courses?q=react&category=programming&level=beginner

GET /api/v1/search/users?q=john&role=instructor

{
  "success": true,
  "data": {
    "id": "uuid",
    "name": "Example",
    "created_at": "2024-01-01T00:00:00Z"
  },
  "meta": {
    "timestamp": "2024-01-01T00:00:00Z",
    "request_id": "req_123456"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid input data",
    "details": {
      "field": "email",
      "reason": "Invalid email format"
    }
  },
  "meta": {
    "timestamp": "2024-01-01T00:00:00Z",
    "request_id": "req_123456"
  }
}

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200

GET /api/v1/courses?limit=20&offset=0

{
  "success": true,
  "data": [...],
  "meta": {
    "pagination": {
      "total": 150,
      "limit": 20,
      "offset": 0,
      "has_more": true
    }
  }
}

GET /api/v1/courses?category=programming&level=beginner&price_min=0&price_max=100

GET /api/v1/courses?sort=created_at&order=desc
GET /api/v1/courses?sort=rating&order=desc

POST /api/v1/webhooks/stripe
X-Signature: stripe_signature

{
  "type": "payment_intent.succeeded",
  "data": {
    "object": {
      "id": "pi_1234567890",
      "amount": 4999,
      "currency": "usd"
    }
  }
}

import { LearnilleAPI } from 'learnille-sdk';

const client = new LearnilleAPI({
  apiKey: 'your-api-key',
  baseURL: 'https://api.learnille.com'
});

// Get courses
const courses = await client.courses.list({
  category: 'programming',
  limit: 10
});

from learnille_sdk import LearnilleAPI

client = LearnilleAPI(
    api_key='your-api-key',
    base_url='https://api.learnille.com'
)

# Get courses
courses = client.courses.list(category='programming', limit=10)

# Get courses
curl -X GET "https://api.learnille.com/api/v1/courses" \
  -H "Authorization: Bearer your-jwt-token"

# Create course
curl -X POST "https://api.learnille.com/api/v1/courses" \
  -H "Authorization: Bearer your-jwt-token" \
  -H "Content-Type: application/json" \
  -d '{"title": "New Course", "description": "Course description"}'