A platform létrehozása - Az AI- operálható.
A OpsIQ egy tiszta REST API, HMAC- dedikált webhorog, egy akció- szerződés regisztere és a hajó SDK-k. Definiáld, hogy milyen események tüzelnek a rendszeredből, milyen cselekvések futhatnak le az MI-n, és milyen adatok olvashatók el biztonságosan. A OpsIQ kezeli az aláírásokat, reléket, ellenőrzési naplót és visszaigazoló áramlást az Ön számára.
Kérés. Aláírt webhorog.
- Te vagy a főnök.OpsIQ APIA te optikailag bearer kulcsoddal.OpsIQellenőrzi a hatókört és a szerepet, lefuttatja a szerződést, ír egy auditsort - majd kilő egy HMAC-aláírással ellátott webhorog vissza a végpontot. Minden hop hitelesítve, idempotens és újra kipróbálják a hiba.
A nullától az élő integrációig 4 lépés.
Létrehozhatsz egy kulcsot, elsütheted az első eseményt, feliratkozhatsz egy webhorog-ra, regisztrálhatsz egy műveletet. Az egész hurkot a homokozóba futtathatod, mielőtt a gyártási adatokhoz érnél.
Szerezz kulcsot!
Regisztráljon be és generáljon egy opciós Bearer API gombot (opq_…) fejlesztői beállításokban, és minden egyes integráció csak a felületek szükséges.
Tűz & előfizetés
A POST aláírása events/fire (vagy használja aSDK), majd a pont bármelyURLminden esetben, aláírva, szállítólevéllel és visszaváltással.
A kereset nyilvántartásba vétele
Aláírt cselekvési szerződés, amely lehetővé teszi a MI-k számára, hogy biztonságosan működjenek, szerepellenőrzésekkel, megerősítési politikával és teljes ellenőrzési nyomvonalzal.
Egy csatlakozóminta. Öt tiszta primitívet.
Bármi, ami platformspecifikus, egy csatlakozóban él. A OpsIQ mag általános marad, a MI kiszámítható, és az integrációd ellenőrizhető marad.
Mondja el a OpsIQ-nak, mi történt.
Tűz univerzális események a platform - vagy a saját egyedi esemény nevek. Minden előfizető reagál valós időben, prioritási sorrendben.
A dokumentum hivatkozási számainvoice.paid, ticket.created, subscription.cancelled, customer.signed_up Vagy a sajátodat.
Fan- out előfizetőkAz MI agy, automatizálási szabályok, tükrös csatlakozók és a webhorog végpontok mind reagálnak.
Prioritási sorrendDeterminista feladás, így a tükrök írni, mielőtt a riasztások tüzet.
Mondja el a OpsIQ-nak, hogy mit tehet az MI.
A cselekvési szerződés egy aláírt JSON nyilatkozat: mit tesz a cselekvés, mely szerepeket tud futtatni, milyen paramétereket fogad el, szükség van-e megerősítésre, és a végpontot kell hívni.
Műveleti séma{
"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
}
Nyomja események a stack - kriptográfiai bizonyíték.
Feliratkozás bármilyenURLMinden eseményre.OpsIQPOSTJSONa HMAC- SHA256-al aláírt hasznos teher a nyers test felett - ellenőrizze néhány sorban.
$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);
A már használt nyelvért az ügyfeleknél.
Három hivatalos SDK kezeli hitelesítés, aláírás, relikvencia, idempotencia billentyűk és gépelt válaszok. Vagy maradjon framwork-mentes - mindenSDKegy vékony csomagolás ugyanazon REST felület körül.
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",
})
Építs egyet, és dugj bele mindent.
A csatlakozó egy PHP-s mappa. A OpsIQ felfedezi, a regiszteren keresztül irányítja az eseményeket, és a platformspecifikus kódod teljesen elkülönül a magtól.
KapcsolattartóidentityProviders(), contextProviders(), registerActions(), subscribers(), handleWebhook().
Manifeszt-vezéreltactions.json és settings.json A szerződés és a konfig bejelentése.
Auto-felfedezettDobd be a mappát, írd alá, és engedd adminba.
Egyszerű angol. Ellenőrzött művelet.
OpsIQsoha nem találja fel a megfelelő hívást. Átsétál a regisztrált szerződések, előkészíti a hasznos teher, kéri a megerősítést, amikor a cselekvés megköveteli, és létrehoz egy teljes ellenőrzési sor, amikor végrehajtja, így egy AI, hogy cselekvés Soha nem lesz olyan MI, akiben nem bízhatsz.
API felület Egy pillanat.
Minden fő végpont, annak authot, idempotencia és per- key kamatláb limit. A teljes gépi olvasható szerződés él az OpenAPI 3.0.3 hivatkozás.
POST /v1/events/fireHMACIgen.1000 / percPOST /v1/actions/runHMACIgen.200 / percPOST /v1/webhooks/testHMACIgen.60 / percGET /v1/customers/{id}HMACIgen.2000 / percGET /v1/ticketsHMACIgen.2000 / percGET /v1/connectorsHMACIgen.2000 / percA kamatlábhatárok kulcsonként vannak, és minden válaszra visszatérnek, X-OpsIQ-RateLimit-Remaining; túllépi a limit-hozamot 429 a Retry-After Fejléc. A teljes gépi olvasható szerződés (minden végpont, séma és hiba) él a OpenAPI 3.0.3 hivatkozás.
Hajó csatlakozó Öt lépés.
A csatlakozó egy önálló mappa. OpsIQ felfedi, a regiszterben drót az események, és a platformspecifikus kód soha nem szivárog a magba.
connector.php meghosszabbítás AbstractConnector.actions.json és settings.json A manifesztek.Egy homokdoboz kulcs és egy horog tesztelő.
Minden munkaterület homokozót mutat: egy külön, a API felületre ható opciós kulcsot, a gyártási adatok érintése nélkül. POST /v1/webhooks/test hogy tűz egy aláírt minta szállítás a végponton, és erősítse meg az aláírás ellenőrzése előtt élő. Self- hosted installs fut az azonos kódút, anélkül, hogy viselkedési sodródás felhő és on-prem.
OpsIQ vs egy DIY integráció.
Amit egy szerződéskötéses, aláírt, ellenőrzött platform ad, az a saját webhorog és az AI- akciós vízvezeték gördítése soha nem fog.
| Képesség | Tekerje a sajátját | 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) | Megváltozások | ✓ |
| Connector pattern: platform code stays isolated | — | ✓ |
Fejlesztői kérdések, Válaszolt.
Auth, aláírások, SDK, sandbox és a csatlakozó modell: mindent, amit az első kérés előtt kérni fogsz.
Authorization: Bearer opq_…. OpsIQ ellenőrzi a kulcs hatókörét és a színész szerepét, mielőtt bármi fut. Webhook külön: minden webhorog OpsIQ küld egy X-OpsIQ-Signature (a nyers test hex HMAC- SHA256 törzse) és X-OpsIQ-Timestamp a visszajátszás védelem, így ellenőrizni minket cserébe, és bejövő webhorog küldesz azonos módon.requires_confirmation Az oldaleffektus előtt egy előnézeti kártyát felhelyez egy emberre.hash_hmac('sha256', $rawBody, $secret) (egy előtag nélküli hexa-emésztődés) és hasonlítsa össze a X-OpsIQ-Signature Fejléc konstans-idő ellenőrzéssel (hash_equals). Minden szállítás tartalmaz egy időbélyegző, egy idempotencia kulcs és egy szállítási azonosító lehet nyomon követni. A PHP snippet ezen az oldalon az egész ellenőrzés.POST /v1/webhooks/test hogy kilőjön egy aláírt mintát a végpontján, és megerősítse az ellenőrzést, mielőtt élőben megy.AbstractConnector, plusz actions.json és settings.json manifesztek. identityProviders(), contextProviders(), registerActions(), subscribers() és handleWebhook(). OpsIQ auto-fedi fel, drótozza az eseményeket, és tartja a platformspecifikus kódot tisztán elkülönítve a magtól.