Add Generic HTTP integration documentation with interactive builder

- Created new Generic HTTP integration docs section (position 1 in custom integrations)
- Added Overview page explaining when to use, how it works, and advanced configurations
- Built interactive 'Build Your Integration' guide with 3 steps:
  - Step 1: Configure API (base URL, auth, pagination, advanced settings)
  - Step 2: Choose data to sync (endpoint, response, field mapping, blueprint config)
  - Step 3: Install and create in Port (dynamic Helm/Docker commands, blueprint JSON, mapping YAML)
- Implemented React components with shared context for seamless state management
- Labeled as 'Generic HTTP (New ⭐)' in sidebar to highlight new feature
- Updated API integration position to 2

Author: Matarp13

docs/build-your-software-catalog/custom-integration/api/_category_.json

@@ -1,4 +1,4 @@
 {
   "label": "API",
-  "position": 1
+  "position": 2
 }

docs/build-your-software-catalog/custom-integration/ocean-http/_category_.json

@@ -0,0 +1,19 @@
+{
+  "position": 1,
+  "label": "Generic HTTP (New ⭐)",
+  "collapsible": true,
+  "collapsed": true,
+  "link": {
+    "type": "generated-index"
+  }
+}
+
+
+
+
+
+
+
+
+
+

docs/build-your-software-catalog/custom-integration/ocean-http/build-your-integration.md

@@ -0,0 +1,50 @@
+---
+sidebar_position: 2
+title: Build Your Integration
+description: Interactive guide to configure and install your integration
+---
+
+import PortApiRegionTip from "/docs/generalTemplates/_port_api_available_regions.md"
+import { IntegrationBuilderProvider, Step1ApiConfig, Step2DataMapping, Step3Installation } from '@site/src/components/GenericHttp';
+
+# Build Your Integration
+
+This interactive guide will help you generate everything you need to connect your API to Port.
+
+**How it works:**
+1. Configure your API connection settings
+2. Choose an endpoint and select which fields to sync
+3. Get your installation commands, blueprint, and mapping configuration
+
+<IntegrationBuilderProvider>
+
+---
+
+## Step 1: Configure Your API
+
+Set up the connection details for your API:
+
+<Step1ApiConfig />
+
+---
+
+## Step 2: Choose What Data to Sync
+
+Select an endpoint and configure which fields to ingest into Port:
+
+<Step2DataMapping />
+
+---
+
+## Step 3: Install and Create in Port
+
+Use the commands and configurations generated from your selections above.
+
+
+<Step3Installation />
+
+:::info Port credentials needed
+Get your `PORT_CLIENT_ID` and `PORT_CLIENT_SECRET` from [Port Settings → Credentials](https://app.getport.io/settings).
+:::
+
+</IntegrationBuilderProvider>