APIs Reference

API interaction patterns for infrastructure automation. curl, httpx, authentication flows, error handling, and protocol-specific reference.

Topics

Topic Description

REST

HTTP methods, status codes, headers, query parameters, HATEOAS

Authentication

Basic, Bearer, OAuth2, mTLS, HMAC, JWT, API keys

curl Patterns

Request construction, response inspection, retries, TLS, file upload

httpx Patterns

Python HTTP client — sync, async, sessions, auth, error handling

Error Handling

Status code decisions, client-side handling, retry strategies, ISE errors

Pagination

Offset, cursor, Link header — ISE ERS, GitHub, Meraki, FastAPI

Rate Limiting

Headers, client throttling, API-specific limits, FastAPI middleware

GraphQL

Queries, mutations, variables, pagination, GitHub GraphQL, introspection

OpenAPI

Spec structure, FastAPI generation, ISE OpenAPI, code generation

Webhooks

Receiving, signature verification, GitHub/Meraki hooks, reliability

gRPC

Protocol Buffers, grpcurl, streaming, Python client/server

API Testing

CLI-first testing, collections as scripts, contract validation