Api Endpoint

Error Handling

• Catch and map errors to HTTP status codes.
• Use consistent error response shape (e.g. { error, message, code }).
• Log errors with structured logs; never expose internals in responses.

Response Shape

• Use project convention (e.g. { data, meta } or { success, result }).
• Document request/response examples in code or docs.
• Keep pagination, sorting, and filtering consistent with existing endpoints.

Tests

• At least smoke test: call endpoint, assert status and basic shape.
• Add unit tests for validation and business logic.
• Add integration test if endpoint touches DB or external services.

Checklist

• Request/response examples
• Validation on inputs
• Authorization check
• Consistent error handling
• Tests (at least smoke)