AgentSkillsCN

api-connector

生成稳健且具备生产级水准的第三方 API 集成，支持重试机制、速率限制以及 DTO 数据传输对象。

SKILL.md
--- frontmatter
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.