Какой HTTP-метод использовать для API, возвращающего данные клиента по номеру карты?

А, слушай, вот смотри, тут такой вопрос подъехал — как правильно дернуть данные по номеру карты. Так вот, блядь, чтобы не выебаться с архитектурой, надо использовать GET, а не какую-то другую хуйню.

А почему именно GET, спросишь? Да потому что, ёпта:

• Идемпотентность: Сколько раз ни дергай — хуйня одна и та же вернётся, сервер не перекосит.
• Семантика HTTP: GET как раз для этого и придуман — чтобы данные получать, а не менять что-то.
• Кэширование: Ответы можно закэшировать, чтобы не ебашить в базу каждый раз, как какой-то клиент захочет инфу.

Как endpoint правильно оформить, чтобы не выглядеть как мартышлюшка:

GET /api/cards/{cardNumber}/customer

Всё чётко, понятно, даже обезьяна догадается, что тут происходит.

Вот тебе пример на Spring Boot, чтобы не изобретать велосипед:

@RestController
@RequestMapping("/api/cards")
public class CardController {

    @GetMapping("/{cardNumber}/customer")
    public ResponseEntity<CustomerDto> getCustomerByCardNumber(
            @PathVariable @Pattern(regexp = "^[0-9]{16}$") String cardNumber) {
        // 1. Валидация формата номера (аннотация @Pattern)
        // 2. Поиск в сервисном слое
        CustomerDto customer = cardService.findCustomerByCard(cardNumber);
        // 3. Обработка отсутствия данных
        return customer != null 
                ? ResponseEntity.ok(customer) 
                : ResponseEntity.notFound().build(); // HTTP 404
    }
}

И ещё, блядь, на посошок:

• Безопасность: Этот endpoint должен быть под замком, а то какой-нибудь пидарас шерстяной подберёт номер и унесёт все данные. Аутентификация, авторизация — без этого никуда.
• Валидация: Всегда проверяй, что тебе в cardNumber прилетает, а не какая-то хуйня с буквами. Регуляркой, как в примере.
• Кэширование: Если данные часто запрашивают, подумай про заголовки Cache-Control, чтобы сервер не вздрочнулся от нагрузки.