Magento 2 Service Contracts & Repositories

Before writing code

Fetch live docs:

1. Fetch https://developer.adobe.com/commerce/php/development/components/web-api/services/ for service contract guide
2. Fetch https://developer.adobe.com/commerce/php/development/components/searching-with-repositories/ for SearchCriteria patterns
3. Web-search site:developer.adobe.com commerce php development components service-contracts for additional reference

Conceptual Architecture

What Service Contracts Are

Service contracts are PHP interfaces that define a module's public API. They guarantee backward compatibility — implementations can change across versions without breaking consumers.

Three Interface Categories