api-connector

name	api-connector
description	Generates robust, production-grade 3rd party API integrations with Retry, Rate Limiting, and DTOs.

API Connector (The Integrator 🔗)

Don't just "hit an endpoint". Build a Bridge.

Integration Standards

1. Architecture (The Gateway Pattern)

• Service Class: StripeService, XenditGateway.
• DTOs (Data Transfer Objects): Never pass raw JSON arrays. Create CreatePaymentRequest, PaymentResponse.
• Interface: PaymentGatewayInterface (allows swapping providers later).

2. Resilience (Anti-Fragile)

• Timeouts: Always set a connect_timeout and read_timeout.
• Retries: Use Exponential Backoff for 5xx errors. Never retry 4xx (Client Error).
• Circuit Breaker: If the API fails 10 times, stop trying for 1 minute.

3. Debugging & Logging

• Log Request/Response: Sanitize secrets (mask API Keys/CC numbers).
• Exceptions: Throw custom exceptions (PaymentFailedException), not generic GuzzleException.