external-integration

Automate secure HTTP integrations with OAuth 2.0, HMAC, and JSONPath mappings.

7|1|Updated Feb 12, 2023
One-click install
npx skills add https://github.com/hirokazu-kobayashi-koba-hiro/idp-server --skill external-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: external-integration
Source: https://github.com/hirokazu-kobayashi-koba-hiro/idp-server/tree/main/.claude/skills/external-integration
Command: npx skills add https://github.com/hirokazu-kobayashi-koba-hiro/idp-server --skill external-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

External Service Integration provides a structured layer to connect to HTTP-based external APIs, enabling reliable data exchange, authenticated access, and scalable integration workflows.

Core Features & Use Cases

  • HTTP Request Executor with retry and rate-limiting
  • MappingRule with JSONPath-based transformations and function support
  • OAuth 2.0, HMAC, and Basic authentication
  • Idempotency support via Idempotency-Key and safe retry semantics
  • Federation-like data flow mappings for partner integrations

Quick Start

Set up a sample external service integration by configuring an HTTP Request Executor with a test endpoint and a MappingRule for data transformation.

Frequently Asked Questions about external-integration

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

FAQPage Schema
How do I build a secure connection to an external HTTP service?

External service integration automates secure connections to HTTP APIs by providing a configurable HTTP Request Executor with multi-factor authentication. It requires OAuth 2.0 or HMAC authentication to ensure reliable, authenticated data exchange with partner APIs.

How do I automate data transformation when connecting to partner APIs?

You can automate data transformation for partner APIs by applying MappingRules with JSONPath-based transformations. This allows you to define structured data flow mappings and execute function support to convert payloads between your system and the external service.

What is the best way to handle rate-limiting and retries for external API requests?

The best way to handle rate-limiting and retries for external API requests is using an HTTP Request Executor with built-in rate-limit aware retry logic. This enforces safe retry semantics and prevents overwhelming the external service during peak traffic.

How does idempotency work when making HTTP requests to external services?

Idempotency in HTTP requests to external services works by utilizing an Idempotency-Key and safe retry semantics. This ensures that duplicate requests caused by network failures do not result in duplicate side effects on the external API.

Can I use HMAC authentication for integration with external services?

Yes, you can use HMAC authentication for external service integration. The system explicitly supports OAuth 2.0, HMAC, and Basic authentication methods to secure HTTP-based API connections and enforce authenticated access.

When do I need JSONPath-based mappings for external service integrations?

You need JSONPath-based mappings for external service integrations when you must transform or route data payloads between different API schemas. MappingRules with JSONPath enable precise data extraction and function support for partner data flows.