Developer Documentation

import requests

BASE_URL  = "https://gateway.appfora.io/api/v1"
PRODUCT   = "YOUR_PRODUCT_ID"
API_KEY   = "af_live_YOUR_KEY"
HEADERS   = {"Authorization": f"Bearer {API_KEY}"}

# ── legal:read ─────────────────────────────────────────────────────
docs = requests.get(f"{BASE_URL}/{PRODUCT}/api/legal/documents", headers=HEADERS)
print("Legal docs:", docs.json())

single = requests.get(
    f"{BASE_URL}/{PRODUCT}/api/legal/documents/privacy-policy", headers=HEADERS)
print("Privacy Policy:", single.json())

config = requests.get(f"{BASE_URL}/{PRODUCT}/api/legal/config", headers=HEADERS)
print("Legal config:", config.json())

# ── legal:generate ─────────────────────────────────────────────────
gen = requests.post(f"{BASE_URL}/{PRODUCT}/api/legal/generate",
    headers=HEADERS, json={"trigger": "api"})
print("Generate:", gen.json())

regen = requests.post(f"{BASE_URL}/{PRODUCT}/api/legal/regenerate",
    headers=HEADERS, json={"trigger": "api"})
print("Regenerate:", regen.json())

requests.put(f"{BASE_URL}/{PRODUCT}/api/legal/config",
    headers=HEADERS,
    json={"company_name": "Acme Ltd", "dpo_email": "[email protected]"})

# ── legal:approve ──────────────────────────────────────────────────
drafts = requests.get(
    f"{BASE_URL}/{PRODUCT}/api/legal/documents/drafts", headers=HEADERS)
print("Drafts:", drafts.json())

doc_id = "DRAFT_DOC_ID"
requests.put(f"{BASE_URL}/{PRODUCT}/api/legal/documents/{doc_id}/publish",
    headers=HEADERS)
requests.put(f"{BASE_URL}/{PRODUCT}/api/legal/documents/{doc_id}/reject",
    headers=HEADERS)

# ── support:articles ───────────────────────────────────────────────
articles = requests.get(
    f"{BASE_URL}/{PRODUCT}/api/support/articles", headers=HEADERS)
print("Articles:", articles.json())

# ── support:ask ────────────────────────────────────────────────────
answer = requests.post(f"{BASE_URL}/{PRODUCT}/api/support/ask",
    headers=HEADERS,
    json={"question": "How do I reset my password?"})
print("Answer:", answer.json())

# ── support:regenerate ─────────────────────────────────────────────
requests.post(f"{BASE_URL}/{PRODUCT}/api/support/generate",
    headers=HEADERS, json={"trigger": "api"})

# ── support:approve ────────────────────────────────────────────────
requests.post(f"{BASE_URL}/{PRODUCT}/api/support/kb/rebuild",
    headers=HEADERS)
requests.put(f"{BASE_URL}/{PRODUCT}/api/support/articles/ART_ID/review",
    headers=HEADERS, json={"approved": True})

# ── Cleanup ────────────────────────────────────────────────────────
# Keys are long-lived — there is no "session close" call.
# Revoke from the Appfora dashboard (Products → API Keys → Revoke)
# or rotate via the management API when no longer needed.
# The gateway invalidates the cached session instantly via pub/sub.
print("Done — revoke or rotate the key when no longer needed.")