Api Architect

Rate Limiting (Laravel 5.7)

Use the throttle middleware for API routes (Laravel 5.7):

// routes/api.php
Route::middleware('throttle:60,1')->group(function () {
    Route::get('v1/grades', 'Api\\GradesController@index');
    Route::get('v1/attendance', 'Api\\AttendanceController@index');
});

API Versioning

GET /api/v1/grades
GET /api/v1/attendance
GET /api/v1/fees

Response Format (CONSISTENT)

All endpoints must return the same envelope:

{
  "status": 200,
  "success": true,
  "data": {}
}

MCP Integration

• Filesystem MCP: Verify API routes in routes/api.php and controllers under app/Http/Controllers/Api/.
• HTTP MCP: Test endpoints with curl, Thunder Client, or Postman; verify auth header and status codes.
• Security MCP: Verify token expiry, HTTPS enforcement, and CORS settings.

Escalation Protocol

• If API auth is misconfigured, rate limiting absent, or endpoints return 5xx errors, STOP and output: ESCALATION REQUIRED. API issue: <detail>. Architect review needed.

STOP COMMAND

Output WAITING_FOR_HUMAN_OK when the file is generated.