📖 API Documentation

All endpoints are 100% public — no API keys, no login needed.
Just copy any CURL command and paste it in your terminal!

📚 Library System — /api/books

Manage a collection of books. Full CRUD operations with search and genre filtering.

GET Get all books

curl https://n8nhttp.alaadin-alynaey.site/api/books

GET Get a single book

curl https://n8nhttp.alaadin-alynaey.site/api/books/1

GET Search books by title

curl "https://n8nhttp.alaadin-alynaey.site/api/books?search=gatsby"

GET Filter by genre

curl "https://n8nhttp.alaadin-alynaey.site/api/books?genre=Fiction"

POST Create a new book

curl -X POST https://n8nhttp.alaadin-alynaey.site/api/books \ -H "Content-Type: application/json" \ -d '{"title":"Learn APIs","author":"Alaadin","genre":"Technology","year":2026}'

PUT Update a book

curl -X PUT https://n8nhttp.alaadin-alynaey.site/api/books/1 \ -H "Content-Type: application/json" \ -d '{"title":"Updated Book Title","year":2026}'

DELETE Delete a book

curl -X DELETE https://n8nhttp.alaadin-alynaey.site/api/books/5

✅ Task Manager — /api/tasks

Track tasks with status, priority, and assignment.

GET Get all tasks

curl https://n8nhttp.alaadin-alynaey.site/api/tasks

GET Get a single task

curl https://n8nhttp.alaadin-alynaey.site/api/tasks/1

GET Filter by status

curl "https://n8nhttp.alaadin-alynaey.site/api/tasks?status=pending"

GET Filter by priority

curl "https://n8nhttp.alaadin-alynaey.site/api/tasks?priority=high"

POST Create a task

curl -X POST https://n8nhttp.alaadin-alynaey.site/api/tasks \ -H "Content-Type: application/json" \ -d '{"title":"Learn HTTP Methods","description":"Study GET, POST, PUT, DELETE","priority":"high"}'

PUT Update task status

curl -X PUT https://n8nhttp.alaadin-alynaey.site/api/tasks/1 \ -H "Content-Type: application/json" \ -d '{"status":"completed","priority":"low"}'

DELETE Delete a task

curl -X DELETE https://n8nhttp.alaadin-alynaey.site/api/tasks/2

🎓 Student Management — /api/students

Manage student records with GPA tracking and major filtering.

GET Get all students

curl https://n8nhttp.alaadin-alynaey.site/api/students

GET Get a student

curl https://n8nhttp.alaadin-alynaey.site/api/students/1

GET Filter by major

curl "https://n8nhttp.alaadin-alynaey.site/api/students?major=CS"

POST Add a student

curl -X POST https://n8nhttp.alaadin-alynaey.site/api/students \ -H "Content-Type: application/json" \ -d '{"name":"Ahmed Ali","email":"ahmed@example.com","major":"CS","gpa":3.8}'

PUT Update student

curl -X PUT https://n8nhttp.alaadin-alynaey.site/api/students/1 \ -H "Content-Type: application/json" \ -d '{"gpa":3.95,"major":"AI"}'

DELETE Delete student

curl -X DELETE https://n8nhttp.alaadin-alynaey.site/api/students/2

📝 Notes System — /api/notes

Create and organize notes with categories and pinning.

GET Get all notes

curl https://n8nhttp.alaadin-alynaey.site/api/notes

GET Get a note

curl https://n8nhttp.alaadin-alynaey.site/api/notes/1

POST Create a note

curl -X POST https://n8nhttp.alaadin-alynaey.site/api/notes \ -H "Content-Type: application/json" \ -d '{"title":"My Study Notes","content":"HTTP is the protocol of the web","category":"Study","is_pinned":true}'

PUT Update a note

curl -X PUT https://n8nhttp.alaadin-alynaey.site/api/notes/1 \ -H "Content-Type: application/json" \ -d '{"content":"Updated content here","is_pinned":false}'

DELETE Delete a note

curl -X DELETE https://n8nhttp.alaadin-alynaey.site/api/notes/1

📁 File Manager — /api/files

Upload and download files. Learn multipart form data handling.

GET List all files

curl https://n8nhttp.alaadin-alynaey.site/api/files

POST Upload a file

# Upload a text file curl -X POST https://n8nhttp.alaadin-alynaey.site/api/files/upload \ -F "file=@myfile.txt" # Upload an image curl -X POST https://n8nhttp.alaadin-alynaey.site/api/files/upload \ -F "file=@photo.jpg"

GET Download a file

curl https://n8nhttp.alaadin-alynaey.site/api/files/download/1 -o downloaded_file.txt

DELETE Delete a file

curl -X DELETE https://n8nhttp.alaadin-alynaey.site/api/files/1

✍️ Blog Platform — /api/blog

Full blog system with posts, tags, and publishing.

GET Get all posts

curl https://n8nhttp.alaadin-alynaey.site/api/blog

GET Get a post

curl https://n8nhttp.alaadin-alynaey.site/api/blog/1

POST Create a blog post

curl -X POST https://n8nhttp.alaadin-alynaey.site/api/blog \ -H "Content-Type: application/json" \ -d '{"title":"My First Post","content":"This is my blog content about APIs","tags":"api,http,learning"}'

PUT Update a post

curl -X PUT https://n8nhttp.alaadin-alynaey.site/api/blog/1 \ -H "Content-Type: application/json" \ -d '{"title":"Updated Post Title","content":"Updated content"}'

DELETE Delete a post

curl -X DELETE https://n8nhttp.alaadin-alynaey.site/api/blog/1

📦 Inventory System — /api/inventory

Track inventory across warehouses with stock monitoring.

GET Get all items

curl https://n8nhttp.alaadin-alynaey.site/api/inventory

GET Get an item

curl https://n8nhttp.alaadin-alynaey.site/api/inventory/1

GET Filter low stock

curl "https://n8nhttp.alaadin-alynaey.site/api/inventory?low_stock=true"

POST Add inventory item

curl -X POST https://n8nhttp.alaadin-alynaey.site/api/inventory \ -H "Content-Type: application/json" \ -d '{"name":"Laptop","sku":"TECH-001","quantity":50,"price":999.99,"category":"Electronics","warehouse":"Main"}'

PUT Update inventory

curl -X PUT https://n8nhttp.alaadin-alynaey.site/api/inventory/1 \ -H "Content-Type: application/json" \ -d '{"quantity":75,"price":899.99}'

DELETE Delete item

curl -X DELETE https://n8nhttp.alaadin-alynaey.site/api/inventory/2

🌤️ Mock Weather API — /api/weather

Practice with weather data for 10 cities. Great for learning query parameters.

GET All available cities

curl https://n8nhttp.alaadin-alynaey.site/api/weather

GET Weather for a specific city

# Dubai curl "https://n8nhttp.alaadin-alynaey.site/api/weather?city=dubai" # Tokyo curl "https://n8nhttp.alaadin-alynaey.site/api/weather?city=tokyo" # London curl "https://n8nhttp.alaadin-alynaey.site/api/weather?city=london" # New York curl "https://n8nhttp.alaadin-alynaey.site/api/weather?city=new york"

GET Compare two cities

curl "https://n8nhttp.alaadin-alynaey.site/api/weather/compare?city1=dubai&city2=london"

🤖 AI Assistant — /api/ai/*

Powered by OpenRouter. Generate text, summarize, classify, validate, and chat.

POST Generate text

curl -X POST https://n8nhttp.alaadin-alynaey.site/api/ai/generate \ -H "Content-Type: application/json" \ -d '{"prompt":"Explain what a REST API is in simple terms","max_tokens":200}'

POST Summarize text

curl -X POST https://n8nhttp.alaadin-alynaey.site/api/ai/summarize \ -H "Content-Type: application/json" \ -d '{"text":"REST APIs work by sending HTTP requests to a server. The server processes the request and returns a response. Common methods include GET for reading data, POST for creating data, PUT for updating data, and DELETE for removing data. Each request includes headers and optionally a body."}'

POST Classify text

curl -X POST https://n8nhttp.alaadin-alynaey.site/api/ai/classify \ -H "Content-Type: application/json" \ -d '{"text":"The new Python 3.12 release includes performance improvements","categories":["Technology","Science","Business","Sports"]}'

POST Validate content

# Grammar check curl -X POST https://n8nhttp.alaadin-alynaey.site/api/ai/validate \ -H "Content-Type: application/json" \ -d '{"text":"I has went to the store yesterday","type":"grammar"}'

POST Chat with AI

curl -X POST https://n8nhttp.alaadin-alynaey.site/api/ai/chat \ -H "Content-Type: application/json" \ -d '{"message":"What is the difference between GET and POST?","context":"api"}'

🔄 Echo & Debug Tools

Learn how HTTP works by seeing your request details.

GET Echo your request

curl https://n8nhttp.alaadin-alynaey.site/api/echo

POST Echo with body

curl -X POST https://n8nhttp.alaadin-alynaey.site/api/echo \ -H "Content-Type: application/json" \ -d '{"message":"Hello from CURL!"}'

GET See your headers

curl https://n8nhttp.alaadin-alynaey.site/api/headers

GET Send custom headers

curl https://n8nhttp.alaadin-alynaey.site/api/headers \ -H "X-My-Name: Alaadin" \ -H "X-My-Class: HTTP101"

GET Health check

curl https://n8nhttp.alaadin-alynaey.site/api/health

GET API info

curl https://n8nhttp.alaadin-alynaey.site/api/info

📊 HTTP Status Codes

Learn what different status codes mean by requesting them.

GET Try different status codes

# 200 OK curl https://n8nhttp.alaadin-alynaey.site/api/status-codes/200 # 201 Created curl https://n8nhttp.alaadin-alynaey.site/api/status-codes/201 # 400 Bad Request curl https://n8nhttp.alaadin-alynaey.site/api/status-codes/400 # 401 Unauthorized curl https://n8nhttp.alaadin-alynaey.site/api/status-codes/401 # 404 Not Found curl https://n8nhttp.alaadin-alynaey.site/api/status-codes/404 # 500 Internal Server Error curl https://n8nhttp.alaadin-alynaey.site/api/status-codes/500

⚡ n8n Integration

Use this API with n8n automation workflows.

Setup Steps:

  1. HTTP Request Node:
    • Method: GET
    • URL: https://n8nhttp.alaadin-alynaey.site/api/books
  2. Create Task from Telegram:
    • Method: POST
    • URL: https://n8nhttp.alaadin-alynaey.site/api/tasks
    • Headers: Content-Type: application/json
    • Body: {"title": "{{$json.message.text}}", "priority": "medium"}
  3. Monitor Inventory:
    • Method: GET
    • URL: https://n8nhttp.alaadin-alynaey.site/api/inventory?low_stock=true
    • Trigger: Schedule node (every hour)