Urobte si platformu Al-operovateľný.
OpsIQodhaľuje čistý RESTAPI, HMAC-podpísaný webhooks, akčná-zmluvný register a ready-to-ship SDKs. Definovať, aké udalosti požiaru z vášho systému, aké akcie AI je dovolené spustiť, a aké údaje je bezpečné čítať.OpsIQmanipuluje s podpismi, záznamami, auditmi a potvrdzovacími tokmi.
Žiadam o pomoc. Podpísaný webhook out.
You post to theOpsIQ APIs tvojím ostrým kľúčom na nosenie.OpsIQkontroluje rozsah a rolu, spúšťa zmluvnú akciu, píše riadok auditu - potom vystrelí HMAC-podpísaný webhok späť do svojho cieľa. Každý hop je overený, nevedomý a retried na zlyhanie.
Od nuly k živej integrácii štyri kroky.
Generovať kľúč, vypáliť svoju prvú udalosť, prihlásiť webhok, zaregistrovať akciu. Môžete spustiť celú slučku proti pieskovisku pred dotykom údajov o výrobe.
Získať kľúč
Zaregistrujte sa a vygenerujte scaped Beader API kľúč (opq_…) v nastaveniach vývojárov a dať každej integrácii len povrchy, ktoré potrebuje.
Páľte & prihlásiť sa
POST a podpísaný events/fire (alebo použite SDK), potom poukážte na akýkoľvek URL v každom prípade, podpísaný, s dodacím číslom a spätnou platnosťou.
Zaregistrujte akciu
Vyhláste podpísanú akčnú zmluvu, aby AI mohla bezpečne prevádzkovať operácie s kontrolou úloh, politikou potvrdenia a úplným auditom.
Jeden vzor konektora. Päť čistých primitívov.
Všetko-špecifické platforma žije v konektore. OpsIQ_ jadro zostáva generické, AI zostáva predvídateľné a vaša integrácia zostáva auditovateľné.
PovedzOpsIQčo sa práve stalo.
Vyvolávajte univerzálne udalosti z vašej platformy - alebo si vytvorte vlastné názvy udalostí, na ktoré bude každý účastník reagovať v reálnom čase a podľa poradia priorít.
Odkaz na udalosťinvoice.paid, ticket.created, subscription.cancelled, customer.signed_up alebo tvoj vlastný.
Predplatitelia fan-outMozog AI, pravidlá automatizácie, zrkadlové konektory a vaše webové háčky koncové body všetky reagovať.
Prioritný príkazDeterministická dispečing, takže zrkadlá písať pred upozornenia požiaru.
Povedz OpsIQ_ čo môže AI robiť.
Akčná zmluva je podpísané JSON vyhlásenie: čo robí akcia, ktoré role ju môžu spustiť, aké parametre akceptuje, či potvrdenie je potrebné, a koncový ukazovateľ volať.
Schéma akcie{
"key": "saas.refund_invoice",
"label": "Refund a paid invoice",
"surface": ["admin"],
"roles": ["owner", "billing_admin"],
"requires_confirmation": true,
"params": {
"invoice_id": { "type": "int", "required": true },
"reason": { "type": "string", "max": 500 }
},
"endpoint": "https://api.you.com/refund",
"audit": true
}
Tlačte udalosti do koša - s kryptografickým dôkazom.
Prihlásiť sa URL_ na každú udalosť. OpsIQ POSTS na JSON užitočné zaťaženie podpísané s HMAC-SHA256 cez surové telo - overiť v niekoľkých riadkoch.
$raw = file_get_contents('php://input');
$sig = $_SERVER['HTTP_X_OPSIQ_SIGNATURE'] ?? '';
$expected = hash_hmac('sha256', $raw, $secret); // hex digest, no prefix
if (!hash_equals($expected, $sig)) http_response_code(401);
$event = json_decode($raw, true);
Drop-in klienti pre jazyk, ktorý už používate.
Tri oficiálne SDK spracovať autentifikáciu, podpisovanie, retráty, orientačné kľúče a zadané odpovede. Alebo zostať rámec-free - každý SDK je tenký obal okolo rovnakého povrchu REST.
import { OpsIQ } from "@opsiq/sdk";
const ops = new OpsIQ({ apiKey: process.env.OPSIQ_KEY });
await ops.events.fire("order.shipped", {
customer_id: 421,
order_ref: "NB-9182",
carrier: "DHL"
});
const result = await ops.actions.run("saas.send_kb_link", {
ticket_id: 5519,
article: "how-to-reset-password"
});
use OpsIQ\Client;
$ops = new Client([
'api_key' => getenv('OPSIQ_KEY'),
]);
$ops->events->fire('order.shipped', [
'customer_id' => 421,
'order_ref' => 'NB-9182',
]);
$result = $ops->actions->run('saas.send_kb_link', [
'ticket_id' => 5519,
'article' => 'how-to-reset-password',
]);
from opsiq import OpsIQ
ops = OpsIQ(
api_key=os.environ["OPSIQ_KEY"],
)
ops.events.fire("order.shipped", {
"customer_id": 421,
"order_ref": "NB-9182",
})
result = ops.actions.run("saas.send_kb_link", {
"ticket_id": 5519,
"article": "how-to-reset-password",
})
Zapojte sa do všetkého.
Konektor je priečinok s jednou triedou PHP. OpsIQ_ objavuje, register prepája udalosti a kód pre konkrétnu platformu zostáva od jadra úplne oddelený.
Sprievodca konektoromidentityProviders(), contextProviders(), registerActions(), subscribers(), handleWebhook().
Manifestovanéactions.json a settings.json deklarovať zmluvy a zverejňovať.
Automaticky objavenéZapíšte priečinok, podpíšte ho, povoľte ho v admin.
Jasná angličtina. Auditované operácie ukončené.
OpsIQ nikdy nevynájde správny hovor. Prechádza registrovanými zmluvami, pripravuje užitočné zaťaženie, žiada o potvrdenie, kedy si to akcia vyžaduje a vyrobí úplný riadok auditu pri jeho vykonaní, takže AI, ktorá môže akt Nikdy sa nestane UI, ktorým nemôžeš veriť.
API povrch na prvý pohľad.
Každý základný koncový ukazovateľ, jeho auth, nemennosť a na kľúč limit sadzby. Plná strojovo čitateľná zmluva žije v OpenAPI 3.0.3 referencie.
POST /v1/events/fireHMACÁno1000 / minPOST /v1/actions/runHMACÁno200 / minPOST /v1/webhooks/testHMACÁno60 / minGET /v1/customers/{id}HMACÁno2000 / minGET /v1/ticketsHMACÁno2000 / minGET /v1/connectorsHMACÁno2000 / minLimity sadzieb sú na kľúč a vrátený pri každej odpovedi ako X-OpsIQ-RateLimit-Remaining; prekročenie limitu vrátenia 429 s Retry-After Záhlavie. Plná strojovo čitateľná zmluva (každý koncový ukazovateľ, schéma a chyba) žije v OpenAPI 3.0.3 referencia.
Zapojte konektor do päť krokov.
Konektor je samostatný priečinok. OpsIQ_ objavuje, register prepája udalosti a kód pre konkrétnu platformu nikdy neuniká do jadra.
connector.php predĺženie AbstractConnector.actions.json a settings.json manifesty.Kľúč od pieskoviska a tester webhhooku.
Každý pracovný priestor odkryje pieskovisko: samostatný scaped kľúč, ktorý zasiahne rovnaký API_ povrch bez dotyku s výrobnými údajmi. POST /v1/webhooks/test vystreliť podpísanú vzorku dodávky na svoj konečný ukazovateľ a potvrdiť si overenie podpisu pred odchodom do živého. Samohostiteľom inštalácie beží rovnakú cestu kódu, bez behaviorálneho posunu medzi cloudom a on-prem.
OpsIQ vs a DIY integrácia.
Čo zmluvy viazané, podpísaný, auditovaný platforma vám dáva, že valcovanie vlastných webhooks a AI-action inštalatérstvo nikdy nebude.
| Schopnosť | Vytvorte si vlastný | OpsIQ |
|---|---|---|
| HMAC-signed requests & webhooks (both ways) | Hand-rolled | ✓ |
| Idempotency keys + replay protection | DIY | ✓ |
| Automatic back-off retries with delivery IDs | DIY queue | ✓ |
| Action-contract registry (AI can't invent calls) | — | ✓ |
| Confirmation policy before side-effects | — | ✓ |
| 100% audit-log coverage on actions | Manual logging | ✓ |
| Official PHP / Node / Python SDKs | Write your own | ✓ |
| OpenAPI 3.0.3 machine-readable contract | Maybe | ✓ |
| Sandbox keys + webhook tester | Build a staging rig | ✓ |
| Cloud & self-hosted parity (same code path) | Vary | ✓ |
| Connector pattern: platform code stays isolated | — | ✓ |
otázky vývojárov, odpovedal.
Auth, podpisy, SDKs, pieskovisko a konektor model: všetko, čo budete pýtať pred prvou žiadosťou.
Authorization: Bearer opq_…. OpsIQ kontroluje rozsah a úlohu kľúča pred spustením. Webhooks sú oddelené: každý webhook OpsIQ_ odosiela nesie X-OpsIQ-Signature (hex HMAC-SHA256 surového tela) a X-OpsIQ-Timestamp pre ochranu pre opakované prehrávanie, takže nás môžete overiť na oplátku, a prichádzajúce webhooks, ktoré odošlete sú overené rovnakým spôsobom.requires_confirmation pred začiatkom vedľajšieho účinku sa vystaví náhľadovej karte pre človeka.hash_hmac('sha256', $rawBody, $secret) (rozptylový trávenie bez predpony) a porovnať s X-OpsIQ-Signature hlavička s nepretržitou kontrolou času (hash_equals). Každá dodávka tiež nesie časovú pečiatku, kľúč nepozornosti a dodacie ID môžete sledovať. PHP snipper na tejto stránke je celé overenie.POST /v1/webhooks/test vystreliť podpísanú vzorku dodávky na svoj konečný ukazovateľ a potvrdiť svoje overenie pred odchodom do živého.AbstractConnectorplus actions.json a settings.json manifesty. identityProviders(), contextProviders(), registerActions(), subscribers() a handleWebhook(). OpsIQ _ auto-objaví ho, prepojí udalosti a udržuje si svoj špecifický kód platformy čisto oddelený od jadra.