Tee alustasta Tekoälyä voidaan käyttää.
OpsIQ paljastaa puhtaan REST API, HMAC-allekirjoitetut webkoukkuja, toiminta-sopimusrekisterin ja valmis-alukseen SDKs. Määrittele mitä tapahtumia tulipalosta järjestelmästäsi, mitä toimia tekoälyllä saa ajaa, ja mitä tietoja on turvallista lukea. OpsIQ käsittelee allekirjoituksia, korjauksia, tarkastuslokit ja vahvistusvirrat sinulle.
Pyydän sisään. -Signeerattu webkoopa.
POST-palveluunOpsIQ APITarkkaavaimellasi.OpsIQ Tarkistaa laajuus ja rooli, suorittaa sopimuksen toiminta, kirjoittaa tarkastusrivin - sitten ampua HMAC-allekirjoitettu webkoukku takaisin päätepiste. Jokainen hyppy on todennettu, idemopotentti ja yritetään uudelleen epäonnistuminen.
Nollasta live-integraatioon Neljä askelta.
Luo avain, ammu ensimmäinen tapahtuma, tilaa webkoukku, rekisteröi toiminto. Voit ajaa koko silmukan vastaan hiekkalaatikko ennen kuin kosketat tuotantotietoja.
Hae avain.
Rekisteröidy ja luo tähystetty karhuAPI avain (opq_…) kehittäjän asetukset, ja antaa jokaiselle integraatio vain pinnat se tarvitsee.
Tulipalotilaus
POST allekirjoitettava events/fire (tai käytäSDK), sitten kohta tahansaURL Allekirjoitettuna, mukana toimituksen tunniste ja varauloskirjaukset.
Rekisteröi toimi
Ilmoita allekirjoitettu toimintasopimus, jotta tekoäly voi suorittaa turvallisesti toimintoja, joissa on tehtävätarkastuksia, vahvistuskäytäntö ja täydellinen kirjausketju.
Yksi liitinkuvio. Viisi puhdasta alkuasukasta.
Kaikki alustakohtainen elää liittimessä.OpsIQ Ydin pysyy geneerisenä, tekoäly pysyy ennustettavana ja integraatio pysyy tarkastettavissa.
Kerro OpsIQ_ mitä juuri tapahtui.
Tulipalo yleistapahtumia alustalta - tai omia mukautettuja tapahtumanimiä. Jokainen tilaaja reagoi reaaliajassa, tärkeysjärjestyksessä.
Tapahtuman viiteinvoice.paid, ticket.created, subscription.cancelled, customer.signed_up Tai sinun.
LannoitustilaajatTekoälyn aivot, automaatiosäännöt, peililiittimet ja webkoukkusi päätepisteet reagoivat.
Etusijainen järjestysMäärittelevä lähetys, joten peilit kirjoittavat ennen hälytystä.
Kerro OpsIQ_ mitä tekoälyllä on lupa tehdä.
Toimintasopimus on allekirjoitettu JSON ilmoitus: mitä toimi tekee, mitkä roolit voivat ajaa sitä, mitä parametreja se hyväksyy, onko vahvistus vaaditaan, ja päätepiste soittaa.
Toimintakaavio{
"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
}
Työnnä tapahtumia pino - salaus todiste.
TilaaURL mihin tahansa.OpsIQ PostitusJSONHMAC-SHA256:n kanssa tehty hyötykuorma - varmista se muutamalla viivalla.
$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);
Pudotat asiakkaita käyttämällesi kielelle.
Kolme virallista SDK:ta käsittelee tunnistautumista, allekirjoitusta, uusintaa, idemponency-avaimia ja kirjoitettuja vastauksia.SDKon ohut kääre saman REST-pinnan ympärillä.
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",
})
-Ei, vaan näppäile.
Yhdistäminen on kansio, jossa on yksi PHP-luokka. OpsIQ löytää sen, rekisteri johdottaa tapahtumat ja alustakohtainen koodi pysyy puhtaana erillään ytimestä.
LiitosopasidentityProviders(), contextProviders(), registerActions(), subscribers(), handleWebhook().
Manifestivetoisetactions.json sekä settings.json ilmoittaa sopimukset ja config.
Automaattinen löytyminenPudota kansio sisään, allekirjoita se, ota se käyttöön admin.
-En. - Tarkastettu operaatio.
OpsIQ ei koskaan keksi oikeaa puhelua. Se kulkee rekisteröityjen sopimusten läpi, valmistelee hyötykuorman, pyytää vahvistusta, kun toimi vaatii sitä, ja tuottaa täydellisen tarkastusrivin, kun se suorittaa, joten tekoäly, joka voi säädös -Ei sinusta tule tekoälyä.
API pinta -Ei, vaan silmäyksellä.
Jokainen päätapahtuma, sen auth, idempotency ja per-avain korkoraja. Täysi koneluettava sopimus elää OpenAPI 3.0.3 reference.
POST /v1/events/fireHMACKyllä1000/ minPOST /v1/actions/runHMACKyllä200/ minPOST /v1/webhooks/testHMACKyllä60/ minGET /v1/customers/{id}HMACKyllä2000/ minGET /v1/ticketsHMACKyllä2000/ minGET /v1/connectorsHMACKyllä2000/ minRate raja on avainta kohti ja palautetaan jokaisen vastauksen X-OpsIQ-RateLimit-Remaining; raja-arvojen ylittäminen 429 jossa Retry-After otsikko. Koko koneluettava sopimus (jokainen päätepiste, skeema ja virhe) elää OpenAPI3.0.3 viite.
Lähetä liitin sisään Viisi askelta.
Liitos on itsenäinen kansio. OpsIQ löytää sen, rekisteri johdottaa tapahtumat, ja alustakohtainen koodi ei koskaan vuoda ytimeen.
connector.php Laajennetaan AbstractConnector.actions.json sekä settings.json -Ei.Hiekkalaatikon avain ja webkookintesteri.
Jokainen työtila paljastaa hiekkalaatikon: erillinen tähystetty avain, joka osuu samaanAPI pinta koskettamatta tuotantotietoja. POST /v1/webhooks/test ampua allekirjoitettu näyte toimitus päätepiste ja vahvistaa allekirjoitusvarmennus ennen kuin menee suorana. Itseohjatut asennukset ajaa identtinen koodi polku, ilman käyttäytyminen ajelehtii pilvi ja on-prem.
OpsIQvs - DIY-kotoutuminen.
Mitä sopimus sitova, allekirjoitettu, tarkastettu alusta antaa sinulle, että kääriminen omia webkoukkuja ja tekoäly-toiminta putkistot koskaan.
| Voimavara | Pyöritä omaasi | 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) | Vaihtelee | ✓ |
| Connector pattern: platform code stays isolated | — | ✓ |
Kehittäjän kysymykset Vastasit.
Auth, allekirjoitukset, SDK, hiekkalaatikko ja liitin malli: kaikki mitä pyydät ennen ensimmäistä pyyntöä.
Authorization: Bearer opq_…. OpsIQ Tarkista avainten laajuus ja näyttelijän rooli ennen kuin mikään toimii. Webkookit ovat erillisiä: jokainen webkookkiOpsIQ lähetyksissä on X-OpsIQ-Signature (raaka-aineen HMAC-SHA256 -heksa) ja X-OpsIQ-Timestamp uusintasuojauksen, jotta voit vahvistaa meidät vastineeksi, ja saapuvat webkoukkuja lähetät tarkistetaan samalla tavalla.requires_confirmation pinnat esikatselukortin ihmiselle ennen sivuvaikutus toimii.hash_hmac('sha256', $rawBody, $secret) (kirous sulaa ilman etuliitettä) ja verrata sitä X-OpsIQ-Signature otsikko, jossa on vakioaikatarkastus (hash_equals) Joka toimituksessa on myös aikaleima, idempotency-avain ja toimitustunnus, jonka voit jäljittää. PHP snippet tällä sivulla on koko vahvistus.POST /v1/webhooks/test -Entä jos et ole?AbstractConnector, plus actions.json sekä settings.json Manifestit. Toteutat identityProviders(), contextProviders(), registerActions(), subscribers() sekä handleWebhook(). OpsIQ auto-löytää sen, johdottaa tapahtumat ja pitää alustakohtainen koodisi puhtaana erillään ytimestä.