Tag

api-design

8 articles tagged with “api-design”

.d.ts A/B-testing ACR AI AI-Search API-gateway API-providers APM ASP.NET-Core Alertmanager Anthropic-API Arize AutoGen Azure-APIM Azure-OpenAI Bedrock Bundler CI Capitalize Claude CoT Copilot Cosmos-DB Cursor DORA DefinitelyTyped Docker-Hub Event-Grid FinOps GHCR GPT Gemini Gemma GitFlow GitHub Google-DeepMind Groq GroupChat HPA Helm ICL Istio JSON JSON-mode LLM LLM-monitoring LLM-security LangChain LangGraph LangSmith Linkerd MCP MTEB Mistral Model-Context-Protocol Node16 OIDC OTEL Omit OpenAI-API OpenTelemetry Outlines P99 PII PII-filtering PagerDuty Partial Phi Phoenix Pick Pinecone Qdrant RAG RAG-evaluation ReAct Record SDK SLI SLM SLO Semantic-Kernel Service-Bus TC39 TTFT Vertex-AI Windsurf a-star agents aggregation ai ai-gateway aks alerting algorithms api-design api-gateway api-versioning apim app-router app-service appsec architecture arm-templates aspnet-core aspnetcore assertion-functions asserts async audit authentication authorization automation azure azure-content-safety azure-front-door azure-functions azure-openai azure-policy azure-storage batch-API bdd benchmarks best-practices bfs bi-encoder bias-detection bicep binary-search branching bst cache-components caching cap-theorem capability-tagging cascading case-based-reasoning chain-of-thought charts chatbot checkpointing chunking ci-cd ci-optimization cicd class-decorator clean-architecture cloud cloud-security cloudevents code-review coding-agents comparison compilerOptions compliance compose concurrency concurrent-rendering conditional-types consistency consistent-hashing constrained-generation constraints consumer-driven container-registry containers content-moderation content-safety context context-compression context-window contract-testing conversational-agents cosmos-db cost-allocation cost-control cost-optimization cost-performance coverage cqrs cross-session csharp cve cypress dapper dashboards dast data-fetching databases dataloader ddd decision-framework declaration-files decorators dependency-injection dependency-scanning deployment-slots deployments deprecation design-patterns devops dfs dijkstra discriminated-unions distributed-tracing distributive docker documentation dotnet dotnet-9 drift-detection dynamic-discovery dynamic-programming e2e-testing ef-core ef-core-9 embeddings engineering environments episodic-memory error-budget evaluation event-driven event-grid event-hubs eventing examples experience-replay experimentalDecorators factuality fail-fast feature-flags federation few-shot fiber fine-tuning flaky-tests flex-consumption frontend function-calling gen-ai-semantic-conventions generics git github-actions goal-decomposition golden-signals gpt-4o grammar graph graphql grounding grpc guardrails hallucination-detection harmful-content hcl health-checks heap hooks hotchocolate http http2 http3 hybridcache iac idempotency identity image-scanning in-context-learning incident-response indexes infer inference infrastructure input-validation integration integration-testing introsort invariant isolation jailbreak jest joins jotai jsonb jwt k8s key-remapping key-vault kiota knapsack knowledge-base kubernetes language latency legacy-code linq load-balancing long-term-memory lost-in-the-middle lower-bound mTLS managed-identity mapped-types materialized-views memoization memory memory-consolidation merge message-queue messaging metadata metrics microservices microsoft minimal-apis mocking mocks model-routing moderation module-augmentation module-resolution modules mongodb monitoring msw multi-agent multi-stage-builds multi-tenant multimodal mvcc narrowing network-security nextjs-16 normalization nosql oauth oauth2 observability oidc on-call online-evals opa open-source openapi orchestration output-format output-validation owasp paas package-exports pact pactflow page-objects parsing partitioning paths pattern-matching performance personal-AI pgvector pinecone pipeline planning playwright plugins policy-as-code polly postgresql pricing production production-monitoring project-references prompt-design prompt-engineering prompt-injection protobuf pulumi python quality quality-gates quality-score quantization queues rag rate-limiting react react-19 react-compiler react-internals react-query react-server-components realtime reasoning recursion recursive-types red-black red-green-refactor red-teaming redis regression-testing release-management replanning resource-limits rest reusable-workflows rls rolling-updates runtime-safety saga-pattern sast sbom scale schema schema-design schema-validation sdlc secrets-management security security-testing self-consistency semantic-similarity serializable server-actions serverless service-bus service-mesh sharding shortest-path sidecar-proxy signalr snapshot-testing software-design sorting spies sql stability state-graph state-management streaming streams strict-mode stride string-types structured-output stubs summarisation supertest supply-chain system-design tail-call tanstack-query task-framing tdd template-literals templates terraform test-architecture test-doubles test-pyramid testcontainers testing testing-patterns testing-strategy threat-modeling token-bucket token-budget token-economics token-limit token-masking token-tracking tokens tokens-per-second tool-calling tool-registry tool-use topological-sort toxicity tracing trajectory transactions trees trie trunk-based tsconfig type-guards type-narrowing type-predicates type-safe-routes type-system type-transforms types typescript unit-testing usage-metrics user-feedback utility-types validation valkey values vault vector-db vector-search vector-store vendor-neutral version-control versioning visual-regression vitest vulnerabilities weaviate web-api web-security websockets window-functions wiremock working-memory workload-identity workspaces xunit yarp zero-shot zero-trust zod zustand

REST Principles in 2026: Resources, Idempotency, and Problem Details

REST Principles in 2026: Resources, Idempotency, and Problem Details

The five constraints that still matter (resources, methods, status codes, statelessness, cacheability), idempotency keys, RFC 9457 problem+json, cursor pagination over OFFSET, ETags + 304s, ASP.NET Core 9 MapGroup.

28 Jan 202613 min

GraphQL with HotChocolate 14: Projections, DataLoaders, and Federation

GraphQL with HotChocolate 14: Projections, DataLoaders, and Federation

When GraphQL beats REST and when it does not, HotChocolate 14 on .NET 9 with [UseProjection] + source-generated DataLoaders, persisted operations, cost analysis, Apollo Federation v2 with @key fields.

30 Jan 202614 min

gRPC on .NET 9: HTTP/3, Streaming, Deadlines, and JSON Transcoding

gRPC on .NET 9: HTTP/3, Streaming, Deadlines, and JSON Transcoding

Four call patterns (unary/server/client/bidi), .NET 9 server + strongly-typed client over HTTP/3, deadlines + ServiceConfig retry policies, gRPC-Web for browsers, JSON transcoding so one service speaks gRPC and REST.

01 Feb 202614 min

WebSockets and SignalR: Heartbeats, Backplanes, and CSWSH Defense

WebSockets and SignalR: Heartbeats, Backplanes, and CSWSH Defense

WebSocket vs SignalR vs SSE vs WebTransport, .NET 9 SignalR Hub + MapHub, scale-out with Redis backplane or Azure SignalR Service, KeepAliveInterval heartbeats, JWT in query string, backpressure with Channels.

03 Feb 202613 min

API Versioning: URL, Header, Media Type, and Sunset Discipline

API Versioning: URL, Header, Media Type, and Sunset Discipline

Asp.Versioning 8 on .NET 9, URL/query/header/media-type schemes, additive evolution, one domain with multiple wire mappers, RFC 8594 Sunset + Deprecation headers, per-version OpenAPI documents.

05 Feb 202612 min

Rate Limiting on .NET 9: Token Buckets, Redis, and Tiered Policies

Rate Limiting on .NET 9: Token Buckets, Redis, and Tiered Policies

Built-in RateLimiter middleware with FixedWindow/SlidingWindow/TokenBucket/Concurrency, partition by user/API key, distributed counters with Redis Lua INCR/EXPIRE, 429 + Retry-After + RateLimit-* headers, layered with APIM.

07 Feb 202613 min

OpenAPI 3.1 on .NET 9: Built-in Spec, Scalar UI, and Kiota Clients

OpenAPI 3.1 on .NET 9: Built-in Spec, Scalar UI, and Kiota Clients

Microsoft.AspNetCore.OpenApi replacing Swashbuckle, OpenAPI 3.1 with JSON Schema 2020-12, Scalar / Redoc UIs, schema + document transformers, Kiota / NSwag SDK generation, Spectral lint + oasdiff in CI.

09 Feb 202613 min

API Gateways in 2026: YARP, Azure APIM, and the AI Gateway Pattern

API Gateways in 2026: YARP, Azure APIM, and the AI Gateway Pattern

YARP for in-process east-west traffic, Azure APIM north-south with policies for auth + rate limit + transform, BFF per channel, defense in depth, and the 2026 AI Gateway: token caps + semantic cache + token metrics.

11 Feb 202615 min