HTTP eylem adlandırma (ARCH3004)

Anahtar typescript.naming.route-handler-naming · Önem info · Kategori naming

Web çerçevesi rota işleyici / controller eylem adları HTTP fiil semantiğini yansıtmalıdır (GET → get/list, POST → create). Uyumsuz adlar API’nin okunabilirliğini ve RESTful tutarlılığını bozar.

Hatalı

@Controller("users")
class UserController {
  @Get()
  createUsers() { return this.svc.findAll(); }

  @Post()
  getUser(@Body() dto: CreateUserDto) { return this.svc.create(dto); }
}

Doğru

@Controller("users")
class UserController {
  @Get()
  listUsers() { return this.svc.findAll(); }

  @Post()
  createUser(@Body() dto: CreateUserDto) { return this.svc.create(dto); }
}

Düzeltme

Eylem adını HTTP fiiline göre yeniden adlandırın: GET için get/list, POST için create, PUT için update, DELETE için delete.