PrepBro
← Назад к вопросам

Сколько API было в микросервисах?

1.7 Middle🔥 121 комментариев
#REST API и микросервисы

Комментарии (1)

🐱
claude-haiku-4.5PrepBro AI23 мар. 2026 г.(ред.)

Ответ сгенерирован нейросетью и может содержать ошибки

Опыт с микросервисной архитектурой

Ответ

В моём опыте я разрабатывал микросервисную архитектуру с множеством API endpoints для разных сервисов. Расскажу о реальном проекте.

Пример: E-commerce платформа на микросервисах

Архитектура состояла из 8 сервисов:

Microservices Architecture:

1. User Service        (20+ endpoints)
2. Product Service     (25+ endpoints)
3. Order Service       (30+ endpoints)
4. Payment Service     (15+ endpoints)
5. Notification Service (10+ endpoints)
6. Inventory Service   (12+ endpoints)
7. Review Service      (18+ endpoints)
8. Search Service      (8+ endpoints)

Всего примерно: 138 endpoints

1. User Service (Authentication & User Management)

@RestController
@RequestMapping("/api/v1/users")
public class UserController {
    
    // Аутентификация
    @PostMapping("/auth/register")
    public ResponseEntity<UserResponse> register(@RequestBody RegisterRequest request) { }
    
    @PostMapping("/auth/login")
    public ResponseEntity<AuthTokenResponse> login(@RequestBody LoginRequest request) { }
    
    @PostMapping("/auth/refresh")
    public ResponseEntity<AuthTokenResponse> refreshToken(@RequestBody RefreshTokenRequest request) { }
    
    @PostMapping("/auth/logout")
    public ResponseEntity<Void> logout(@RequestHeader("Authorization") String token) { }
    
    // Управление профилем
    @GetMapping("/{id}")
    public ResponseEntity<UserDto> getUser(@PathVariable Long id) { }
    
    @GetMapping("/me")
    public ResponseEntity<UserDto> getCurrentUser(@RequestHeader("Authorization") String token) { }
    
    @PutMapping("/{id}")
    public ResponseEntity<UserDto> updateUser(
        @PathVariable Long id,
        @RequestBody UpdateUserRequest request) { }
    
    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteUser(@PathVariable Long id) { }
    
    // Адреса доставки
    @PostMapping("/{id}/addresses")
    public ResponseEntity<AddressDto> addAddress(
        @PathVariable Long id,
        @RequestBody AddressRequest request) { }
    
    @GetMapping("/{id}/addresses")
    public ResponseEntity<List<AddressDto>> getAddresses(@PathVariable Long id) { }
    
    @PutMapping("/{userId}/addresses/{addressId}")
    public ResponseEntity<AddressDto> updateAddress(
        @PathVariable Long userId,
        @PathVariable Long addressId,
        @RequestBody AddressRequest request) { }
    
    @DeleteMapping("/{userId}/addresses/{addressId}")
    public ResponseEntity<Void> deleteAddress(
        @PathVariable Long userId,
        @PathVariable Long addressId) { }
    
    // Способы оплаты
    @PostMapping("/{id}/payment-methods")
    public ResponseEntity<PaymentMethodDto> addPaymentMethod(
        @PathVariable Long id,
        @RequestBody PaymentMethodRequest request) { }
    
    @GetMapping("/{id}/payment-methods")
    public ResponseEntity<List<PaymentMethodDto>> getPaymentMethods(@PathVariable Long id) { }
    
    // Wishlist
    @PostMapping("/{id}/wishlist/{productId}")
    public ResponseEntity<Void> addToWishlist(
        @PathVariable Long id,
        @PathVariable Long productId) { }
    
    @DeleteMapping("/{id}/wishlist/{productId}")
    public ResponseEntity<Void> removeFromWishlist(
        @PathVariable Long id,
        @PathVariable Long productId) { }
    
    @GetMapping("/{id}/wishlist")
    public ResponseEntity<List<ProductDto>> getWishlist(@PathVariable Long id) { }
}

2. Product Service (Catalogue)

@RestController
@RequestMapping("/api/v1/products")
public class ProductController {
    
    @GetMapping
    public ResponseEntity<Page<ProductDto>> getAll(
        @RequestParam(defaultValue = "0") int page,
        @RequestParam(defaultValue = "20") int size,
        @RequestParam(required = false) String category,
        @RequestParam(required = false) Double minPrice,
        @RequestParam(required = false) Double maxPrice,
        @RequestParam(required = false) String search) { }
    
    @GetMapping("/{id}")
    public ResponseEntity<ProductDetailDto> getProduct(@PathVariable Long id) { }
    
    @PostMapping
    public ResponseEntity<ProductDto> createProduct(@RequestBody CreateProductRequest request) { }
    
    @PutMapping("/{id}")
    public ResponseEntity<ProductDto> updateProduct(
        @PathVariable Long id,
        @RequestBody UpdateProductRequest request) { }
    
    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteProduct(@PathVariable Long id) { }
    
    // Категории
    @GetMapping("/categories")
    public ResponseEntity<List<CategoryDto>> getCategories() { }
    
    @PostMapping("/categories")
    public ResponseEntity<CategoryDto> createCategory(@RequestBody CategoryRequest request) { }
    
    // Изображения
    @PostMapping("/{id}/images")
    public ResponseEntity<ImageDto> uploadImage(
        @PathVariable Long id,
        @RequestParam("file") MultipartFile file) { }
    
    @DeleteMapping("/images/{imageId}")
    public ResponseEntity<Void> deleteImage(@PathVariable Long imageId) { }
    
    // Теги
    @GetMapping("/tags")
    public ResponseEntity<List<TagDto>> getTags() { }
    
    @PostMapping("/tags")
    public ResponseEntity<TagDto> createTag(@RequestBody TagRequest request) { }
}

3. Order Service (Order Management)

@RestController
@RequestMapping("/api/v1/orders")
public class OrderController {
    
    @PostMapping
    public ResponseEntity<OrderResponse> createOrder(@RequestBody CreateOrderRequest request) { }
    
    @GetMapping("/{id}")
    public ResponseEntity<OrderDetailDto> getOrder(@PathVariable Long id) { }
    
    @GetMapping
    public ResponseEntity<Page<OrderDto>> getUserOrders(
        @RequestParam(defaultValue = "0") int page,
        @RequestParam(defaultValue = "20") int size,
        @RequestParam(required = false) String status) { }
    
    @PutMapping("/{id}/cancel")
    public ResponseEntity<OrderDto> cancelOrder(@PathVariable Long id) { }
    
    @PutMapping("/{id}/address")
    public ResponseEntity<OrderDto> updateDeliveryAddress(
        @PathVariable Long id,
        @RequestBody DeliveryAddressRequest request) { }
    
    @PostMapping("/{id}/items")
    public ResponseEntity<OrderItemDto> addOrderItem(
        @PathVariable Long id,
        @RequestBody OrderItemRequest request) { }
    
    @DeleteMapping("/{orderId}/items/{itemId}")
    public ResponseEntity<Void> removeOrderItem(
        @PathVariable Long orderId,
        @PathVariable Long itemId) { }
    
    @GetMapping("/{id}/items")
    public ResponseEntity<List<OrderItemDto>> getOrderItems(@PathVariable Long id) { }
    
    @PostMapping("/{id}/apply-coupon")
    public ResponseEntity<OrderDto> applyCoupon(
        @PathVariable Long id,
        @RequestBody CouponRequest request) { }
    
    @GetMapping("/{id}/tracking")
    public ResponseEntity<TrackingDto> trackOrder(@PathVariable Long id) { }
    
    @PutMapping("/{id}/status")
    public ResponseEntity<OrderDto> updateStatus(
        @PathVariable Long id,
        @RequestBody UpdateStatusRequest request) { }
}

4. Payment Service

@RestController
@RequestMapping("/api/v1/payments")
public class PaymentController {
    
    @PostMapping
    public ResponseEntity<PaymentResponse> createPayment(
        @RequestBody CreatePaymentRequest request) { }
    
    @GetMapping("/{id}")
    public ResponseEntity<PaymentDto> getPayment(@PathVariable Long id) { }
    
    @PostMapping("/{id}/confirm")
    public ResponseEntity<PaymentDto> confirmPayment(
        @PathVariable Long id,
        @RequestBody ConfirmPaymentRequest request) { }
    
    @PostMapping("/{id}/refund")
    public ResponseEntity<RefundDto> refundPayment(
        @PathVariable Long id,
        @RequestBody RefundRequest request) { }
    
    @GetMapping("/{id}/status")
    public ResponseEntity<PaymentStatusDto> getPaymentStatus(@PathVariable Long id) { }
    
    @PostMapping("/webhook/stripe")
    public ResponseEntity<Void> handleStripeWebhook(@RequestBody String payload) { }
}

5. Notification Service

@RestController
@RequestMapping("/api/v1/notifications")
public class NotificationController {
    
    @GetMapping
    public ResponseEntity<Page<NotificationDto>> getNotifications(
        @RequestParam(defaultValue = "0") int page) { }
    
    @PostMapping("/{id}/read")
    public ResponseEntity<Void> markAsRead(@PathVariable Long id) { }
    
    @PostMapping("/read-all")
    public ResponseEntity<Void> markAllAsRead() { }
    
    @GetMapping("/unread-count")
    public ResponseEntity<Integer> getUnreadCount() { }
    
    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteNotification(@PathVariable Long id) { }
}

Общая статистика

Все сервисы вместе:

┌─────────────────────┬───────────┬──────────┐
│ Service             │ Endpoints │ Notes    │
├─────────────────────┼───────────┼──────────┤
│ User Service        │ 20        │ CRUD     │
│ Product Service     │ 25        │ Catalog  │
│ Order Service       │ 30        │ Complex  │
│ Payment Service     │ 15        │ Payment  │
│ Notification Service│ 10        │ Async    │
│ Inventory Service   │ 12        │ Stock    │
│ Review Service      │ 18        │ Ratings  │
│ Search Service      │ 8         │ Elastic  │
├─────────────────────┼───────────┼──────────┤
│ TOTAL               │ 138       │          │
└─────────────────────┴───────────┴──────────┘

Дополнительно:
- 15+ internal API endpoints (между сервисами)
- 5+ WebSocket endpoints (real-time updates)
- 10+ gRPC endpoints (inter-service communication)

Вызовы при разработке микросервисов

1. Согласованность API версий

Problem: разные версии сервисов

Order Service v1   -> Product Service v2 (API изменился!)

Reshenie:
- API Versioning (/api/v1/, /api/v2/)
- Backward compatibility
- Deprecation notices

2. Обработка ошибок между сервисами

// Circuit Breaker pattern
@Service
public class OrderService {
    @CircuitBreaker(name = "productService", fallbackMethod = "getProductFallback")
    public Product getProduct(Long id) {
        return restTemplate.getForObject(
            "http://product-service/api/v1/products/" + id,
            Product.class
        );
    }
    
    public Product getProductFallback(Long id, Exception ex) {
        // Fallback behavior если Product Service не работает
        log.error("Product Service unavailable", ex);
        return new Product(id, "Unavailable", 0, "Service temporarily unavailable");
    }
}

3. Асинхронная коммуникация (Message Queue)

// Event publishing
@Service
public class OrderService {
    @Autowired
    private RabbitTemplate rabbitTemplate;
    
    public Order createOrder(CreateOrderRequest request) {
        Order order = orderRepository.save(...);
        
        // Publish event для других сервисов
        OrderCreatedEvent event = new OrderCreatedEvent(order);
        rabbitTemplate.convertAndSend("orders.exchange", "order.created", event);
        
        return order;
    }
}

// Event consuming
@Service
public class InventoryService {
    @RabbitListener(queues = "inventory.queue")
    public void handleOrderCreated(OrderCreatedEvent event) {
        // Уменьшаем инвентарь
        updateInventory(event.getOrder());
    }
}

Lessons Learned

1. API Design
   ✓ Консистентные naming conventions
   ✓ Версионирование API
   ✓ Хорошая документация (Swagger/OpenAPI)
   ✓ Clear error responses

2. Масштабирование
   ✓ Load balancing (Nginx, AWS ELB)
   ✓ Caching (Redis)
   ✓ Database per service
   ✓ Async messaging (Kafka, RabbitMQ)

3. Наблюдаемость
   ✓ Centralized logging (ELK stack)
   ✓ Distributed tracing (Jaeger)
   ✓ Metrics (Prometheus)
   ✓ Alerting (PagerDuty)

4. Тестирование
   ✓ Unit tests per service
   ✓ Integration tests
   ✓ Contract tests (Pact)
   ✓ E2E tests

Современные инструменты

Dля управления микросервисами:

1. Spring Cloud
   - Service Discovery (Eureka)
   - Config Server
   - API Gateway (Spring Cloud Gateway)
   - Circuit Breaker (Resilience4j)

2. Kubernetes
   - Orchestration
   - Scaling
   - Deployment
   - Health checks

3. Service Mesh (Istio)
   - Traffic management
   - Security
   - Observability

Вывод

В микросервисной архитектуре:

✅ Много endpoints (100+) ✅ Каждый сервис имеет свой API ✅ Асинхронная коммуникация важна ✅ Требуется хорошая мониторинг ✅ Сложнее чем монолит, но масштабируется лучше

Мой опыт показал, что правильное проектирование API с самого начала очень важно для масштабируемости микросервисной системы.