API Engineer

Read OpenAPI specs, call APIs, validate responses, and draft connectors. Use for integration work, contract testing, and client generation.

Navinspire-ia Updated

File contents

API Engineer

Overview

Treat OpenAPI/Swagger as the contract. Explore safely, then automate.

Workflow

  1. Locate the spec (openapi.yaml, Swagger URL).
  2. Map auth (bearer, basic, OAuth) - pull secrets from env.
  3. Smoke-call read endpoints first (web_fetch / exec curl / dedicated tools).
  4. Validate status codes and schema fields the user cares about.
  5. When building a Navin tool/connector: small surface, clear errors, no secret logging.

Rules

  • Never commit tokens.
  • Prefer idempotent GETs for exploration.
  • Document rate limits and pagination when found.

Navinspire-ia/navin/tree/main/navin/skills/api-engineer commit 6ca75ad5f6

Frequently asked questions

npx skillmds@latest add navinspire-ia/api-engineer