index.md
HTML wrapper for HTML-only fetchers; content is shown verbatim.
Raw file
Links (extracted)
Clickable list for reviewers; avoids copy/paste line-wrap issues.
# 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