api-troubleshooting
Debug external and internal API failures — timeout, rate limit, authentication, webhook, latency, retry
npx skills add majiayu000/claude-skill-registry --skill api-troubleshooting --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Skill: API Troubleshooting — Debug de Integrações ## Quando Usar - Job Laravel falha silenciosamente ao chamar Gemini, ElevenLabs, Late API, Meta Ads ou Asaas - Webhook do AutoFix Pipeline (`glitchtip.example.com/autofix/callback/`) não chega ou chega duplicado - Google Indexing retorna 429 ou 403 e artigos param de ser indexados - `api.myapp.example.com/health` OK mas pipeline de notícias trava numa etapa específica ## Contexto **APIs externas em produção neste servidor:** | API | Usado por | Tipo de Auth | Rate Limit típico | |-----|-----------|-------------|-------------------| | Gemini | NewsApp Image + Blog | API Key | 60 req/min (free) | | ElevenLabs | NewsApp Podcast | API Key | quota mensal | | Late API | NewsApp Social + SR Social Bot | API Key | por plano | | Meta Ads Graph v22 | NewsApp + SR Ads | Bearer Token (expira abr/2026) | 200 calls/hr/user | | Meta CAPI | NewsApp Newsletter | Access Token | — | | Asaas | MyApp billing | API Key | — | | Google Indexing | NewsApp + SR | Service Account OAuth2 | 200 URLs/dia (quota compartilhada!) | | Cloudflare API | DNS, R2, Tunnels | API Token | — | | GlitchTip Webhook | AutoFix Pipeline | HMAC secret | — | **Paths relevantes:*
- Quando Usar
- Contexto
- Passos / Comandos
- 1. Diagnóstico rápido de falha externa
- 2. Testar API manualmente com curl verboso
- 3. Debug de rate limiting (429)
- 4. Debug de webhook (AutoFix Pipeline)
- 5. Timeout e connection issues
- 6. Analisar falhas em jobs falhados
- 7. Monitorar chamadas API em tempo real
- 8. Checar SSL/TLS de APIs externas
- Observações
Ver últimos erros de HTTP em jobs Laravel cd /home/deploy/api-myapp grep -i "curl\|guzzle\|http\|timeout\|connect\|refused\|429\|401\|403\|500" storage/logs/laravel.log | tail -50 Mesma coisa para MyApp grep -i "curl\|guzzle\|http\|timeout\|429\|401" /home/deploy/myapp/storage/logs/laravel.log | tail -30 Jobs falhados na fila sudo -u deploy php /home/deploy/api-myapp/artisan queue:failed | head -20 sudo -u deploy php /home/deploy/api-myapp/artisan queue:failed --show-batch | grep -A5 "google\|gemini\|late\|eleven" Testar Gemini (pegar GEMINI_API_KEY do .env) curl -sv -X POST \
What does the api-troubleshooting skill do?
Debug external and internal API failures — timeout, rate limit, authentication, webhook, latency, retry
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-troubleshooting --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
