building-integrations

Integrate third-party APIs in .NET with adapters, webhooks, and Polly.

Updated Jan 13, 2026
One-click install
npx skills add https://github.com/FortiumPartners/ensemble-vnext --skill building-integrations
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: building-integrations
Source: https://github.com/FortiumPartners/ensemble-vnext/tree/main/packages/skills/building-integrations
Command: npx skills add https://github.com/FortiumPartners/ensemble-vnext --skill building-integrations

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides robust patterns and best practices for integrating external third-party APIs into your .NET applications, ensuring reliability, security, and maintainability.

Core Features & Use Cases

  • Adapter Pattern: Encapsulate vendor SDKs behind domain interfaces for clean separation.
  • Webhook Handling: Securely verify incoming webhook signatures (HMAC-SHA256) and ensure idempotency.
  • Resilient HTTP Clients: Utilize IHttpClientFactory with Polly for retries, circuit breakers, and timeouts.
  • Secret Management: Securely manage API keys and secrets using IOptions and Azure Key Vault.
  • Use Case: Integrate with Stripe for payments, Twilio for SMS, or HubSpot for CRM, handling potential network issues and ensuring data consistency.

Quick Start

Use the building-integrations skill to implement a Stripe payment gateway adapter.

Frequently Asked Questions about building-integrations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate third-party APIs in .NET using the adapter pattern?

To integrate third-party APIs in .NET, the adapter pattern encapsulates vendor SDKs behind domain interfaces, ensuring clean separation of external dependencies from your core application logic.

How do I securely verify webhook signatures and ensure idempotency for services like Stripe?

You can securely verify webhook signatures using HMAC-SHA256 validation to confirm authenticity, while tracking processed event IDs ensures idempotency, preventing duplicate actions when services like Stripe resend payloads.

How do I configure resilient HTTP clients with IHttpClientFactory and Polly in .NET?

Resilient HTTP clients are configured using IHttpClientFactory with Polly policies to automatically handle transient failures through retries, circuit breakers, and timeouts when communicating with external APIs.

What is the best way to manage API keys and secrets when integrating external services like Twilio?

Secure secret management for external services like Twilio is achieved using the IOptions pattern combined with Azure Key Vault, protecting sensitive API keys without hardcoding them in application configuration files.

Does this API integration approach work for CRM systems like HubSpot as well as payment gateways?

Yes, the integration patterns apply broadly across CRM systems like HubSpot, communication platforms like Twilio, and payment gateways like Stripe, providing robust HTTP handling and maintainable adapters for various external APIs.

Why do my third-party API calls fail during network outages, and how can I prevent data inconsistency?

API calls fail during network outages due to unhandled transient faults; implementing Polly circuit breakers and webhook idempotency prevents cascading failures and ensures data consistency during recovery.