Backend API Integration

Saloon provides a structured library for integrating external APIs in Laravel. It lets you build connector classes, request classes, and readonly DTOs that handle API interactions with built-in error handling, keeping your code maintainable and type-safe across your Laravel application.

Create Saloon connectors and request classes in your app/Services/Api/ directory, paired with readonly DTOs in app/DataTransferObjects/Api/. This structure separates concerns, ensures type safety, and centralizes error handling for all external service calls.

Yes. Build Pest test suites alongside your Saloon integrations to mock API responses and validate request handling. Testing catches integration bugs early and ensures your API client behaves correctly under different scenarios without hitting live services.

Saloon integrates naturally into Laravel's service layer pattern. Add service-layer methods that wrap your Saloon connectors and requests, giving you a clean API for controllers and jobs while keeping Saloon's request and response logic encapsulated.

Saloon supports comprehensive error handling through request classes and service methods. You can catch failed responses, retry logic, and custom exceptions, then map errors to domain-specific handling—keeping your application resilient when external services fail or return unexpected data.

Readonly DTOs provide type safety, IDE autocomplete, and validation for API response data. They prevent accidental mutations, document expected response shapes, and make it easier to refactor when external APIs change.