# if.api (API integrations) — public inventory + demo plan (black/white)

**Audience:** external reviewers + operators  
**Reality gate:** `docs/22-ifttt-handover-and-roadmap.md` (single-host; do not imply shipped integrations without evidence)  
**Naming (enforced):** see `AGENTS.md` + `if.registry.json`

This document is the public-facing “what integrations exist?” inventory for `if.api`.

---

## 0) What this is (and is not)

This is:
- a public-safe inventory of `if.api` integrations with explicit status (shipped/demo/roadmap/out-of-scope)
- a receipt-first approach: every “demo” item must have an IF.TRACE/T3 receipt (not just a claim)

This is not:
- a claim that any third-party integration is deployed on the current single-host system unless it is linked to receipts and reproducible steps

Canonical `if.api` path shape (do not claim deployed unless verified):
- `/if/api`

---

## 1) Status definitions (black/white)

- **shipped**: deployed on the current environment *and* evidenced with public, no-login receipts
- **demo**: runnable demo exists (no internal access), bound to IF.TRACE/T3 receipts
- **roadmap**: described in internal/embedded papers, but not reviewable yet (no public demo + receipts)
- **out-of-scope**: explicitly not planned

---

## 2) Inventory (no tables)

### Integration A — GitHub webhook → normalized event envelope (demo)

Status:
- demo (receipt-backed)

Inputs:
- GitHub “push” webhook JSON (sample payload)

Outputs:
- normalized “event envelope” JSON (demo schema; not a published IF.bus contract yet)

Public demo (HTML-first):
https://infrafabric.io/static/hosted/review/if-api-github-webhook-demo/2026-01-05/index.html

IF.TRACE/T3 receipt (shareId):
https://infrafabric.io/static/trace/Z_kiBtTQHztidcgYYaSRy4UK

Notes (black/white):
- This demo proves deterministic transformation of a known input blob into a known output blob (hash-bound by IF.TRACE/T3).
- This demo does not prove any production GitHub auth, rate-limit handling, or live webhook delivery pipeline.

---

### Integration B — GitHub Search API (roadmap)

Status:
- roadmap (mentioned in embedded audit; not verified on this deployment)

Inputs:
- search query + optional auth token (not published here)

Outputs:
- repository metadata + matches; intended to feed “open source monitoring” workflows

Receipts:
- none published yet

---

### Integration C — arXiv API / RSS monitoring (roadmap)

Status:
- roadmap (mentioned in embedded audit; not verified on this deployment)

Inputs:
- arXiv RSS feed or API query

Outputs:
- paper metadata + change detection for monitoring workflows

Receipts:
- none published yet

---

### Integration D — YouTube Data API v3 (roadmap)

Status:
- roadmap (mentioned in embedded audit; not verified on this deployment)

Inputs:
- channel/video query + API key (not published here)

Outputs:
- video metadata intended for monitoring workflows

Receipts:
- none published yet

---

### Integration E — OpenAI Whisper API (roadmap)

Status:
- roadmap (mentioned in embedded audit; not verified on this deployment)

Inputs:
- audio blob + API key (not published here)

Outputs:
- transcript text + timing metadata

Receipts:
- none published yet

---

### Integration F — Discord webhook / bot monitoring (roadmap)

Status:
- roadmap (mentioned in embedded audit; not verified on this deployment)

Inputs:
- Discord events + bot token (not published here)

Outputs:
- monitored messages + extracted signals

Receipts:
- none published yet

---

### Integration G — Multi-model bridge (external reference)

Status:
- roadmap for this deployment (external repo exists; not wired into IF.TRACE/T3 in this workspace)

Reference:
https://github.com/dannystocker/mcp-multiagent-bridge

Receipts:
- none published here

---

### Integration H — OpenRouter (out-of-scope / revoked)

Status:
- out-of-scope for public demo (revoked key is cited in embedded audit; no public demo planned)

Receipts:
- none published here

---

### Integration I — Zapier/IFTTT (out-of-scope)

Status:
- out-of-scope (explicitly described as not planned in the embedded audit narrative)

Receipts:
- none

---

## 3) What must be added to move roadmap → demo

For any integration to move from roadmap to demo, publish:
1) a minimal integration contract (inputs/outputs, auth boundary, rate limits)
2) a runnable demo bundle (no internal access)
3) IF.TRACE/T3 receipt links (HTML-first) that bind the demo outputs
