README

This library defines an interface for an API client responsible for performing internet search requests. It is intended to be used as a shared contract between applications and concrete HTTP clients.

Installation

composer require adachsoft/internet-search-contract

Usage

Implement the AdachSoft\\InternetSearchContract\\InternetSearchClientInterface in your application and inject your implementation wherever you need to perform internet search calls.

Domain-specific exceptions provided by this package:

• AdachSoft\\InternetSearchContract\\InternetSearchException base exception for search-related errors,
• AdachSoft\\InternetSearchContract\\ResourceExhaustedException indicates that the underlying service or resource limits were exhausted,
• AdachSoft\\InternetSearchContract\\RetriableException indicates that the operation can be safely retried later.

License

This library is released under the MIT License.