API Design Review

Review code from an API design and contract perspective.

Review Checklist

Naming & Consistency

• Verify endpoint/method naming follows conventions
• Check parameter naming is clear and unambiguous
• Ensure consistent patterns across similar endpoints
• Verify HTTP methods match semantics (GET=read, POST=create, etc.)

Request & Response Design

• Check request payloads are minimal and well-structured
• Verify response shapes are consistent across endpoints
• Ensure pagination is implemented for list endpoints
• Check filtering/sorting capabilities where needed