Skip to main content
Version: 2.74.3

HTTP Service

The HTTP Service is a core service type that runs within Watt (the Node.js Application Server). It provides a fast, flexible foundation for building custom APIs and web services using Fastify.

The HTTP Service handles custom application logic, business rules, and API endpoints that aren't automatically generated from your database schema. It's perfect for authentication, complex business logic, third-party integrations, and custom endpoints.

For a high level overview of how Watt and its services work, please reference the Overview guide.

Features​

  • Fastify-based: Built on the fast and lightweight Fastify framework
  • Plugin System: Add custom functionality with Fastify plugins
  • TypeScript Support: Write plugins in JavaScript or TypeScript
  • Programmatic API: Start services programmatically in tests or applications
  • Fully Typed: Complete TypeScript definitions for type-safe development
  • Hot Reloading: Automatic reload during development with Watt
  • Service Mesh Integration: Seamless communication with other services in your Watt application

When to Use HTTP Service​

HTTP Service is ideal for:

  • Custom Business Logic: Implement complex business rules and workflows
  • Authentication & Authorization: Handle user authentication and access control
  • Third-party Integrations: Connect to external APIs and services
  • Custom Endpoints: Create specialized API endpoints not covered by database services
  • Middleware & Processing: Add request/response processing, validation, and transformation
  • Microservice Architecture: Build focused services that handle specific domains

Issues​

If you run into a bug or have a suggestion for improvement, please raise an issue on GitHub.

Quick Start​

The easiest way to create an HTTP Service is within a Watt application:

# Create a new Watt application
wattpm create my-app

# This will create a workspace with HTTP Service included
cd my-app

# Start in development mode
wattpm dev

For service-specific configuration and advanced usage, see the Configuration guide.

Integration with Other Services​

HTTP Services work seamlessly with other service types in your Watt application:

  • Database Services: Access auto-generated database APIs
  • Composer Services: Expose your HTTP service through an API gateway
  • Frontend Stackables: Serve frontend applications alongside your APIs

TypeScript Support​

Generate TypeScript definitions for your HTTP Service:

# Generate types for all services (run from Watt app root)
wattpm build

# Or for standalone service
platformatic service compile

Issues

If you run into a bug or have a suggestion for improvement, please raise an issue on GitHub or join our Discord feedback channel.