integrationis.fun — API Docs

v1.0 · Workshop

O tomto API

Middleware pro workshop System Integrations (ServiceNow). Demonstruje REST API volání, Webhooky, Data Enrichment, AI integraci a E-bonding (bi-directional sync).

Base URL: https://integrationis.fun

Všechny POST endpointy přijímají a vrací application/json. Autentizace není vyžadována (workshop prostředí).

POST /api/enrich Data Enrichment

Simuluje obohacení dat o počasí a státní svátky pro danou lokalitu. ServiceNow volá tento endpoint, aby získal kontext před eskalací tiketu.

Request Body (JSON)
{
  "incident_number": "INC001001",
  "location": "London"
}
Response (příklad)
{
  "status": "success",
  "incident_number": "INC001001",
  "location": "London",
  "weather": "V Londýně je 15°C, zataženo a prší.",
  "holiday": "Dnes je Bank Holiday (státní svátek)."
}
POST /api/ai LLM Orchestration

Předá popis problému a kontext (počasí, svátky) do LLM přes OpenRouter a vrátí automaticky vygenerovanou zdvořilou odpověď uživateli v češtině.

Request Body (JSON)
{
  "description": "User cannot connect to VPN",
  "context": "V Londýně je 15°C, prší. Dnes je Bank Holiday."
}
Response (příklad)
{
  "generated_text": "Dobrý den, omlouváme se za potíže s připojením k VPN..."
}
POST /api/tickets E-bonding: Příjem tiketu (Webhook)

ServiceNow odešle tiket do Partner Portalu pomocí Outbound REST. Tiket se uloží do Vercel KV databáze a zobrazí se na dashboardu.

Request Body (JSON)
{
  "sys_id": "abc123xyz",
  "number": "INC001001",
  "short_description": "Network down in London office"
}
Response (příklad)
{
  "message": "Ticket successfully received by Partner Portal"
}
POST /api/resolve E-bonding: Odeslání řešení zpět (Bi-directional)

Partner Portal odešle řešení zpět do ServiceNow přes Table API (PATCH). Tiket je označen jako vyřešený (state: 6) a odstraněn z KV databáze.

Request Body (JSON)
{
  "sys_id": "abc123xyz",
  "resolution_notes": "Vyřešeno restartem síťového zařízení na straně partnera."
}
Response (příklad)
{
  "status": "resolved",
  "sys_id": "abc123xyz",
  "snow_response": {
    "status": 200,
    "ok": true
  }
}
GET /dashboard Partner Dashboard (UI)

Vizuální přehled všech aktivních tiketů přijatých ze ServiceNow. Obsahuje tlačítko pro vyřešení každého tiketu s odesláním zpět do ServiceNow.

Response (příklad)
← HTML stránka s tabulkou tiketů