Добавляйте название сущности к параметрам идентификаторов (v1.0.0)

Добавляйте название сущности к параметрам идентификаторов (v1.0.0)

И в шаблонах эндпоинтов и в Kotlin-методов не используйте название "id" - всегда добавляйте тип идентифицируемой сущности.

Правильно:

@RestController
class JournalController {

    @DeleteMapping("/{entryId}")
    fun deleteEntry(entryId: UUID) {
        // ...
    }
}

Не правильно

@RestController
class JournalController {

    @DeleteMapping("/{id}")
    fun deleteEntry(id: UUID) {
        // ...
    }
}

Это повышает наглядность кода, оставляет возможность обратносовместимо и согласованно добавлять новые параметры-идентификаторы и уменьшает вероятность передачи клиентами идентификаторов в неправильном порядке в методах, которые получают на вход несколько идентификаторов.