Construtor de Conectores de API

Use isso quando o trabalho for adicionar uma superfície de integração nativa do repositório, não apenas um cliente HTTP genérico.

O objetivo é corresponder ao padrão do repositório host:

• layout do conector
• esquema de configuração
• modelo de autenticação
• tratamento de erros
• estilo de teste
• fiação de registro/descoberta

Quando Usar

• "Construir um conector Jira para este projeto"
• "Adicionar um provedor Slack seguindo o padrão existente"
• "Criar uma nova integração para esta API"
• "Construir um plugin que corresponda ao estilo de conector do repositório"

Diretrizes

• não invente uma nova arquitetura de integração quando o repositório já tiver uma
• não comece apenas com a documentação do fornecedor; comece primeiro com os conectores existentes no repositório
• não pare no código de transporte se o repositório esperar fiação de registro, testes e documentação
• não copie conectores antigos cegamente se o repositório tiver um padrão mais recente e atual

Fluxo de Trabalho

1. Aprenda o estilo da casa

Inspecione pelo menos 2 conectores/provedores existentes e mapeie:

• layout de arquivos
• limites de abstração
• modelo de configuração
• convenções de repetição/paginação
• ganchos de registro
• fixtures e nomenclatura de testes

2. Refine a integração alvo

Defina apenas a superfície que o repositório realmente precisa:

• fluxo de autenticação
• entidades-chave
• operações principais de leitura/escrita
• paginação e limites de taxa
• modelo de webhook ou polling

3. Construa em camadas nativas do repositório

Fatias típicas:

• configuração/esquema
• cliente/transporte
• camada de mapeamento
• ponto de entrada do conector/provedor
• registro
• testes

4. Valide contra o padrão de origem

O novo conector deve parecer óbvio na base de código, não importado de um ecossistema diferente.

Formatos de Referência

Estilo Provedor

providers/
  existing_provider/
    __init__.py
    provider.py
    config.py

Estilo Conector

integrations/
  existing/
    client.py
    models.py
    connector.py

Estilo Plugin TypeScript

src/integrations/
  existing/
    index.ts
    client.ts
    types.ts
    test.ts

Lista de Verificação de Qualidade

• corresponde a um padrão de integração existente no repositório
• a validação de configuração existe
• a autenticação e o tratamento de erros são explícitos
• o comportamento de paginação/repetição segue as normas do repositório
• a fiação de registro/descoberta está completa
• os testes espelham o estilo do repositório host
• a documentação/exemplos são atualizados se esperados pelo repositório

Habilidades Relacionadas

• backend-patterns
• mcp-server-patterns
• github-ops