Rest Graphql Debug — Debug REST/GraphQL APIs: status codes, auth, schemas, repro
Rest Graphql Debug — Debug REST/GraphQL APIs: status codes, auth, schemas, repro
Finding
Denne side er vigtig, fordi den giver Hermes en konkret, sikker og lagdelt metode til at debugge REST- og GraphQL-integrationer uden at gætte.
What it is
Det er en officiel optional Hermes-skill til API-fejlfinding med fokus på statuskoder, auth, request-format, schemas, timeouts, pagination, idempotency og reproducerbare curl-eksempler. Den viser, hvordan Hermes bør bruge `terminal` til curl, `execute_code` til Python requests, `web_extract` til vendor-docs og `delegate_task` til større CRUD-test-sweeps. Siden er især praktisk, fordi den kombinerer teknisk diagnose med sikker token-håndtering og public-safe rapportering.
Should we use it?
Use now. For Lisa’s Hermes+n8n+LangGraph mission er API-fejlfinding et kerneområde, fordi n8n workflows, LangGraph-agenter og Hermes-tools ofte afhænger af eksterne endpoints, webhooks, auth og schemas. Skill’en passer godt til vores princip om først at isolere laget, derefter rette fejlen, og den reducerer risikoen for overengineering ved at bruge simple native Hermes-værktøjer før større orkestrering.
Recommendation
Installer og brug skill’en som standard runbook ved API-, webhook- og integrationsfejl, men kun i manuelle eller reviewede debug-sessioner med streng redaktion af tokens, headers og private payloads.
Use now
- Når n8n-webhooks fejler med 401, 403, 404, 422, 429 eller 5xx.
- Når LangGraph eller Hermes kalder en REST/GraphQL API og får uventet status, tomt body eller forkert schema.
- Når en integration virker i Postman, men fejler i kode, agent-flow eller n8n.
- Når der skal laves reproducerbare curl-eksempler til vendor-support.
- Når vi skal verificere pagination, idempotency, rate limits eller contract drift.
- Når public-safe debugging skal dokumenteres uden secrets, logs eller env-værdier.
Do not use / wait
- Brug den ikke til UI-rendering, database performance, DNS/firewall-infra eller serverdrift uden API-lag.
- Brug den ikke til automatiseret bred scanning af eksterne APIs uden godkendelse.
- Brug den ikke til at logge fulde tokens, cookies, private payloads eller persondata.
- Vent med `delegate_task` CRUD-sweeps, hvis API’en ikke har testmiljø, rate-limit-buffer eller klar tilladelse.
- Brug ikke `curl -k` eller usikre TLS-workarounds i permanent kode.
Public page note
Rest Graphql Debug kan beskrives offentligt som en optional Hermes-skill til sikker, reproducerbar REST/GraphQL-fejlfinding med fokus på auth, schemas, statuskoder og redigerede bug reports.