Backend - TLDR This API

The backend is built with Hono and provides API endpoints for article summarization.

Features

  • URL Content Extraction: Fetches and parses HTML content from URLs
  • Text Summarization: Uses OpenAI API to generate concise summaries
  • Error Handling: Comprehensive error handling for various failure scenarios
  • Static File Serving: Serves frontend assets and shared utilities

API Endpoints

POST /api/summarize

Summarizes article content or URL.

Request Body:

{ "content": "URL or article text", "isUrl": true/false }

Response:

{ "success": true, "summary": "Generated summary...", "title": "Article Title", "originalUrl": "https://example.com" // only for URLs }

Error Response:

{ "success": false, "error": "Error description" }

GET /api/health

Health check endpoint.

Response:

{ "status": "ok", "timestamp": "2024-01-01T00:00:00.000Z" }

Environment Variables

  • OPENAI_API_KEY - Required for AI summarization

Error Handling

The API handles various error scenarios:

  • Invalid URLs or unreachable content
  • OpenAI API failures
  • Malformed requests
  • Content too short to summarize
  • Network timeouts