# Shinecode API Contracts

## Principle
The API is a contract between independently deployed systems.
Laravel owns the contract. Next.js consumes the contract.

## Rules
1. Never guess response structures.
2. Never silently change API semantics.
3. Document breaking changes.
4. Prefer explicit resource shapes.
5. Validate input on Laravel.
6. Validate response assumptions on frontend.
7. Use consistent error formats.
8. Paginate collections.
9. Avoid returning unnecessary data.