Vývojová platforma · Všeobecné API · webhooks · konektory

Urobte si platformu Al-operovateľný.

Call 2,415 named operations through one contract-generated API, with least-privilege scopes, workspace pinning, dry-run validation and replay-safe writes. Subscribe to canonical events through HMAC-signed background webhooks, or build a governed package in the six-stage Connector Builder.

Skryté kľúče na doručiteľa2,415 contract actionsOpenAPI 3.0.3 + PostmanDodávka webhóok HMAC
Žiadosť o rozsah pôsobnosti
Podpísaný webhok out → 200 OK
Živé Akcia na doručiteľa → OpsIQ → podpísaná webhook POST /api/v1.php Autorizácia: Nosič { "action": "lístky. odpoveď," "dry_run": pravda } Overiť · Spustiť · Audit key + pracovná plocha ✓ rozsah + zmluva ✓ Vysledovanie žiadosti koncový ukazovateľ webovej stránky X-OpsIQ-Event: vstupenka. overiť HMAC → rukoväť 200 OK
2,415pomenované Všeobecné API akcie
69rozsahy najmenej privilegovaných oblastí
dry_runValidovať zmluvy o zápise pred vykonaním
24hÚspešný prehrávanie impotentného textu
Životný cyklus žiadosti

Skrytá žiadosť. Podpísal udalosť.

POST /api/v1.php s rozlíšeným Beader kľúčom. OpsIQ kolísky pracovného priestoru, potvrdzuje akčnú zmluvu a oprávnenia, potom vykoná alebo sucho-beží ho. Napísané kanonické udalosti opúšťajú prostredníctvom HMAC-podpísaný dodací frontu s vysledovateľnými pokusmi a ohraničené spätné väzby.

Webhook HMAC-SHA256 - prilietajúce a odchádzajúce užitočné zaťaženie webhooku sa podpisuje na surovom tele; API nazýva autentifikáciu s rozlíšeným kľúčom na Beader.
Automatické spätné odkúpenie - neúspešné dodávky späť a znovu sa skúste, s dodacím dokladom môžete vystopovať.
Prehrávanie-safe writes - úspešné nevedomé zápisy vrátiť rovnakú odpoveď pre 24 hodiny; súbežné duplikáty zdieľajú jednu pohľadávku.
Aplikácia POST /api/v1.php Autorizácia: Nosič idempotence_key: idem_31c7 OVERITE - SPUSTITE - AUDIT Váš koncový ukazovateľ POST /webhooks overiť HMAC 200 OK kľúč + pracovný priestor pripnutý rozsah + úloha skontrolovaná potvrdená zmluva spustiť alebo suchý beh DOKLAD VYHLÁSENIA O POVOLENÍ NA WEBOK { X-OpsIQ-Event: vstupenka. X-OpsIQ-Delivery: dlv_8f2a9 X-OpsIQ-Timestamp: 1786584362 X-OpsIQ-Signature: 9c4e0a7b... } dodaný
01 Žiadosť o nosenie 02 pin pracovná plocha 03 Potvrdená zmluva 04 spustiť alebo suchý beh 05 udalosť podpísaná v fronte
Rýchly štart

Od kľúča k riadenej integrácii tri kroky.

Vydajte si aspoň kľúč privilege, objavte generovanú zmluvu, nechajte spustiť zápis a potom sa prihláste na webhow, keď vaša aplikácia potrebuje pozadie dodanie udalosti.

Zmluvná konzolaPripojený
VŠEOBECNÉ API · zmluva riadená 1 · Generovať kľúč opq_live_xxx · jeden scaped Beader kľúč 2 · Objaviť zmluvy POST /api/v1.php · meta. actions 3 · Overiť zápis vstupenky. odpoveď · suchý_run: pravda 4 · Prihlásiť sa k udalostiam vstupeniek. odstránené · doručenie HMAC
SpustiťSuchý_run → schválený zápis, rovnaká zmluva
01

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.

02

Objaviť & potvrdenie

Čítanie meta.actions, meta.action a meta.scopes; použitie dry_run na overenie zápisu pred vykonaním.

03

Spustiť & prihlásenie

Pridajte kľúč na písanie, potom prihláste svoj koncový ukazovateľ do kanonické udalosti, ktoré vaša aplikácia potrebuje.

Ako to do seba zapadá

Jeden vzor konektora. Päť čistých primitívov.

Čokoľvek konkrétne platforma žije v konektore OpsIQ jadro zostáva generické, AI zostane predvídateľné a vaša integrácia ostáva kontrolovateľná.

01
Spúšťače

Povedz OpsIQ čo sa práve stalo.

Vydajte sa na kánonické podujatia z vašej platformy, alebo zadefinujte regulovanú vlastnú udalosť. Odberatelia dostanú podujatie prostredníctvom registrovaných pravidiel priority a dodania.

Odkaz na udalosť
invoice.paid kánonické udalosti UI mozogživý kontext pravidlá,Priorita 20 zrkadlonajprv písať webhookpodpísané
Univerzálne + vlastné udalostiinvoice.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.
02 / Akčné zmluvy

Povedz OpsIQ čo má UI dovolené robiť.

Každá uvedená operácia dostane generovanú zmluvu: rozsah, funkcia, čítanie alebo zápis druhu, riziko, potvrdenie politiky, žiadosť a odpoveď schémy, suché-run podpora, nejasnosti a stabilné chyby.

Schéma akcie
UI nemôže vymyslieť akcieMôže sa len opýtať na tie, ktoré ste zaregistrovali. Potvrdzovacia politikaRiskantné akcie spúšťajú náhľadovú kartu pred akýmkoľvek vedľajším účinkom. Úloha + povrchová výplňKaždá akcia vyhlasuje role a povrchy povolené spustiť.
generovaná akčná zmluva · JSON
{
  "action": "tickets.reply",
  "kind": "write",
  "scopes": ["tickets.write", "admin"],
  "feature": "ticket_system",
  "risk": "medium",
  "confirmation": "recommended",
  "idempotency": "supported",
  "dry_run": true,
  "request": { "type": "object" },
  "response": { "required": ["success"] }
}
03 / Podpísané webhooks

Tlačte udalosti do koša - s kryptografickým dôkazom.

Subscribe any URL to any of the 52 deliverable events. OpsIQ POSTs the JSON payload signed with HMAC-SHA256 over the scheme version, the timestamp, the delivery ID and the body together, not the body alone, so yesterday's delivery cannot be replayed at you today.

Prehrávanie ochranyVysledovateľné ID doručenia5-step back-off
Odkaz na webovú stránku
over webhook - php
$raw = file_get_contents('php://input');
$sig = $_SERVER['HTTP_X_OPSIQ_SIGNATURE'] ?? '';   // "v2=<hex>"
$ts  = (int)($_SERVER['HTTP_X_OPSIQ_TIMESTAMP'] ?? 0);
$id  = (int)($_SERVER['HTTP_X_OPSIQ_DELIVERY'] ?? 0);

if (abs(time() - $ts) > 300) http_response_code(401);   // replay window
[$ver, $hex] = array_pad(explode('=', $sig, 2), 2, '');  // split the prefix

$signed   = $ver . '.' . $ts . '.' . $id . '.' . $raw;   // NOT the body alone
$expected = hash_hmac('sha256', $signed, $secret);
if (!hash_equals($expected, $hex)) http_response_code(401);

$event = json_decode($raw, true);   // $id is stable across retries
04 / SDK

Použite direct HTTP alebo generujte klienta, ktorý uprednostňujete.

Úplný generálAPI je zverejnená ako OpenAPI 3.0.3 a Postman. PHP referenčných odosielateľov plus uzol a Python integračné klienti pokrývajú podpísanú udalosť a toky webhook; každý stack môže volať rovnaký JSON Akčná plocha priamo.

príklady klientov,
const response = await fetch(`${base}/api/v1.php`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.OPSIQ_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    action: "tickets.reply",
    dry_run: true,
    idempotency_key: crypto.randomUUID(),
    body: "Thanks. We are checking this now."
  })
});
$payload = json_encode([
  'action' => 'tickets.reply',
  'dry_run' => true,
  'idempotency_key' => bin2hex(random_bytes(16)),
  'body' => 'Thanks - we are checking this now.',
]);

$ch = curl_init($base . '/api/v1.php');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => $payload,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('OPSIQ_KEY'),
    'Content-Type: application/json',
  ],
]);
response = requests.post(
    f"{base}/api/v1.php",
    headers={
        "Authorization": f"Bearer {os.environ['OPSIQ_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "action": "tickets.reply",
        "dry_run": True,
        "idempotency_key": str(uuid.uuid4()),
        "body": "Thanks - we are checking this now.",
    },
)
Priame JSON HTTPOpenAPI 3.0.3Zber poštáraPomocníci v oblasti integrácie
05 / Vzor konektora

Zapojte sa do všetkého.

Konektor je riadený balíček generovaný alebo importovaný prostredníctvom identity, Auth, Test, Akcie, Spúšťače a Recenzie. Jeho manifest deklaruje schopnosti povrchy OpsIQ je povolené ich odhaliť.

Otvoriť šesťstupňového staviteľa
Šesť riadených fázIdentita, Auth, Test, Akcie, Spúšťače a Review udržať vytváranie balíkov vysvetliteľné. Zmluvne riadený8 profiles and 57 capability types declare the surfaces a package implements. UvoľňovanieKontroly bezpečnosti, pôvodu a zhody sa vykonávajú pred tým, ako sa obal považuje za pripravený.
Od zámeru k bezpečnému konaniu

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ť.

Zmluva uzavretá. UI navrhuje len akcie, ktoré ste zaregistrovali.
Pred vedľajšími účinkami to potvrďte. Riskantné akcie povrch náhľad karty ako prvý.
Úplne stiahnuté. Každý rýchly, odpoveď a výsledok akcie zachytený v histórii AI.
4 krokyzámer → audit
HMACpodpísané pred vykonaním
"Návrat Adamovej poslednej faktúry" Krok 1 · riešenie zámerov → matched: saas. refund_faktúra povrch: admin · rola: majiteľ · krok 2 Potvrdenie Krok 3 · Potvrdiť & znak náhľadová karta · faktúra #8421 Potvrdiť Krok 4 · Riadok auditu herec · prompt · výsledok · 412ms Len vlastník · exportovateľný ako CSV
Žiadne vymyslené hovoryiba zmluvný register
Potvrdenénáhľad pred vedľajšími účinkami
Vyhľadávanieaktér + zmluva + výsledok
Odkaz

API povrch na prvý pohľad.

One JSON POST surface exposes 2,415 named actions. Each generated contract declares auth scopes, read/write kind, risk, confirmation, request schema, dry-run, idempotency and stable errors.

OpenAPI 3.0.3 referencia
ČinnosťAutorizáciaBezpečnosť zápisuLimit
Napísať akciePOST /api/v1.php · potvrdená zmluva
ACTION tickets.replytickets.writesuchý_run + nevyžiadanosťNastavené / hodina
ACTION security.reportsecurity.writesuchý_run + nevyžiadanosťNastavené / hodina
ACTION platform.routes.writeadminpotvrdenie + kľúčNastavené / hodina
Prečítať a objaviť akcieRovnaká plocha POST · stabilné obálky
ACTION meta.actionsVerejný objavLen čítanieNastavené / hodina
ACTION tickets.listtickets.readLen čítanieNastavené / hodina
ACTION connectors.listconnectors.readLen čítanieNastavené / hodina
PeopleOS HR akcieCured hr.* zmluvy · hr.read / hr.write rozsah pôsobnosti
ACTION hr.people.listhr.readLen čítanieNastavené / hodina
ACTION hr.people.createhr.writesuchý_run + nevyžiadanosťNastavené / hodina
ACTION hr.org.treehr.readLen čítanieNastavené / hodina
PeopleOS HR neodosiela udalosti v HR webhooku. Dostaňte sa na ten istý povrch POST alebo si prihláste k podujatiam, ktoré publikujú iné moduly. ĽudiaOS API a konektory a PeopleOS časť developera referencieModul je právo na udelenie, takže kľúč bez hr dostane odmietnutie, nie prázdny zoznam. Čo je PeopleOS HR.

Limity sadzieb sú nakonfigurované podľa kľúča v hodinovom okne. X-RateLimit-Limit, X-RateLimit-Remaining a X-RateLimit-Reset; odmietnuté žiadosti o vrátenie 429 s Retry-AfterPoužite . Zmluva OpenAPI 3.0.3 alebo Zber poštára generované z rovnakých prevádzkových registrov.

Zostrojiť konektor

Zostavte, otestujte a uvoľnite šesť fáz.

Začnite od riadeného profilu alebo definujte zmluvu sami. Staviteľ potvrdzuje každú etapu predtým, než vytvorí samostatný konektorový balík.

1Identita. Názov, slimák, profil a deklarované plochy spôsobilosti.
2Auth. API kľúč, Beader, Základné, OAuth 2.0, HMAC alebo vlastný klient.
3Test. Overte ohraničené nastavenia pripojenia pred balením.
4Akcia. Mapa s názvom operácie, parametre, rozsahy a riziko.
5Spúšťače. Deklarovať prichádzajúce udalosti, webhooks, prieskumy a synchronizácia správanie.
6Review. Skontrolujte generovanú zmluvu a prejsť priechodom.
Test pred loďou

Overte to bezpečne, potom prejdite priechodom.

Použitie dry_run na podporovaných písanie akcií, spustiť ohraničené skúšku pripojenia staviteľa a skontrolovať generované manifest a zmluvu pred vydaním. Kontrola platnosti balíka kontroly spôsobilosti názvy, nastavenia, proveniencie a požadované súbory; pracovníci pozadia zvládnuť reaktívne prieskumy a odchádzajúce dodávky.

Písmená so suchým chodom Skúška na pripojenie k pripojeniu Zhoda zmluvy Dodávka na ron
konektor. php · php
Trieda AcmeConnector rozšírenia AbstractConnector { verejná funkcia slimák (z angl. slimp) reťazec { návrat 'acme'; } verejná funkcia Názov ((): reťazec { návrat 'Acme'; } verejná funkcia opis ((): reťazec { návrat "Acme most"; } / / Použiť mená z ConnectorContract verejná funkcia schopnosti ((): pole { návrat ["činnosti", 'Webhook']; } verejná funkcia NastavenieSchema(): pole { návrat [['kľúč' => 'tón', "typ" => 'heslo']]; } verejná funkcia testConnection (skúšobná koncepcia)pole $settings): pole { návrat ["úspech" => pravda]; } verejná funkcia handleWebhook [] pole $payload, pole $headers, pole $settings ): pole { návrat ["úspech" => pravda]; } }
01 · Connector contract 2.4

Balík nemôže požadovať spôsobilosť jeho kód nemá.

OpsIQ\Connectors\ConnectorContract je autorita. Runtime discovery, Builder, first-party packages, conformance, General API a každý odkaz čítal jeden register. Deklarovať schopnosť a tri súbory musia súhlasiť so sebou pred OpsIQ trasy jeden riadok pre vás.

FIG. 01balíček konektorov, manifest dielov scale 1:1 · contract 2.4
  1. 01 connector.php trieda času
  2. 02 IdentityProvider.php stabilný externý kľúč
  3. 03 SalesIngest.php zmierenieSales ()
  4. 04 actions.json uvedené operácie
  5. 05 settings.json konfigurácia operátora
  6. 06 connector_contract.json strojovo čitateľný orgán
07 signature.json jedna HMAC nad SHA256 z každého súboru uvedeného vyššie, plus dôkaz o pôvode ed25519
Matica spôsobilosti all 57, as registered
akcie, spúšť webhook journey_events kontext guest_lookup Identita sales sales_reconciliation Vyúčtovanie payments obchod inbound_ticket outbound_reply ticket_merge sync_users sync_departments sync_orders sync_products sync_projects customer_import security_events security_native_block survey reply_feedback promo_audience promo_feed email_mailbox inbound_email outbound_email mailbox ai_tickets ai_reply ai_brain_aware native_api platform_bridge native_data unit description in lists block_registry inbound_comment outbound_note outbound_notification oauth reviews lokálne toto site_intelligence analyzátory comms admin_assets enterprise_hooks durable_queue ticket_mirror attachment_bridge database_migrations scheduled_workers conflict_resolution
generované 30 deklaratívne 20 predĺženie 7
Dva podpisy, dve otázky.

hmac-sha256 nad deterministickým užitočným zaťažením jedného súboru SHA-256 hashes odpovede bola zmenená od podpisu- A. ed25519 odpovede na podpis bolo podpísané Nabtech, kontrolovateľné s zviazaným verejným kľúčom a žiadne zdieľané tajomstvo. Upraviť jeden bajte a prvé zastavenie zodpovedajúce.

marketplace.json je mimo podpisu podľa definície: inštalátor ho napíše po podpise, takže vydavateľ by ho nikdy nepodpísal.
02 · tools/mutation_proof. php

Strážca, ktorý nikdy nezlyhal. je nepotvrdená.

Zelené testy vám dnes nič nepokazia. Nehovoria, že strážnik, ktorý ste napísali, zastaví vec, ktorú bolo napísané zastaviť, pretože strážca, ktorá sa nikdy nevykonáva, prechádza presne ako strážca a nič nerobí. Takže zastavujeme jeho srdce zámerne a žiadame, aby monitor kričal.

strážca · čitateľná rola musí odmietnuť deštruktívne operácie CH1 verify_commerce_contracts
src/Connectors/CommerceRoleMapVerifier.php ZMRAZENÉ
211    /* A read role must never reach a destructive operation. */
212-   if ($isRead && $isDestructive) {
212+   if (false) {
213        $errors[] = "read role '{$role}' points at a destructive op";
214        return false;
215    }
Presne jedna Textový zápas je potrebný. Nula alebo dve zhody a dôkaz sa zastaví skôr, než môže klamať.
$ php tools/mutation_proof.php --spec=proofs.json
1[ ok ]hash    sha256 4f2a9c1e…
          remember the file exactly as it is
2[ ok ]control exit 0
          green BEFORE anything is touched
3[ ok ]mutate  1 match, lint ok
          one replacement, then php -l the mutant
4[RED ]prove   exit 1
          and "read role destructive" IS in the failures
5[ ok ]restore bytes written
          the original, not a regenerated copy
6[ ok ]verify  sha256 matches
          and the check is green again
 ══ PROVEN. file restored, hash matched, 1 proof run, 0 failed.
Zlyhalo dôkaz, že nikdy Dôkazy, že sa pokazila kontrola, nie sú dôkazom toho, že strážnik pracuje.

Mutácia sa nikdy nepoužila.

Text vyhľadávania sa nezhodoval, súbor bol nedotknutý, apartmán prešiel a dôkaz nahral zelená pod starým kódom o kóde, ktorý nebol nikdy starý. Chytený tým, že vyžaduje presne jeden textový zápas a porovnanie súborov hašéz oboch stranách.

Mutácia zlomila niečo iné.

Suite sa červená, pretože súbor prestal spracovať alebo topánkytrap zomrela, a dôkaz zaznamenal červený, ktorý nemal nič spoločné so strážcom. Chytený linting mutanta a vyžadujú pomenované skúška medzi poruchami.

Nemôže nechať mutanta na disku.

Každá mutácia kopíruje originál na bokomer mimo webového stromu, píše marker pomenovania vynikajúcej zmeny a je odstránená od rukoväte na každej únikovej ceste. Značka z havarovaného spustiť je ctený pred ďalšou mutáciou tohto súboru.

03 · Conformance

Certifikácia je príkaz s únikovým kódom.

Not a review queue where somebody reads your code and forms an opinion. Run the same suites we run, on your own machine, before you submit. 8 published JSON Schemas under doc/contracts/schemas/ pokrytie nastavenia, akcie, Stavebné špecifikácie, cesty a obchodné eventy mapovanie, pracovné postupy recepty, konektor zmluvy a vydanie manifestov.

  1. manifests spracovať a vzájomne súhlasiť
  2. schopnosti existujú na bežeckej triede
  3. interfaces implementovaný, ak je deklarovaný
  4. files každý požadovaný súbor
  5. akcie, zodpovedá manifestu činností
  6. destructive vyhlásenie o potvrdení
  7. Identita stabilný externý kľúč, nie e-mail
  8. opakovaný záznam opakovaných aktualizácií, nikdy duplikátov
  9. Podnik Vyhlásenia zodpovedajú rozšíreniu
  10. Docs ČÍTAJTE, HOVORÍ, ZMENA
  11. schémy každý JSON potvrdzuje
exit 0 acme: conformant against contract 2.4 Zlyhajúci apartmán pomenuje šek a spis.
$ php tools/test_connector_conformance_all.php --connector=acme $ php tools/test_connector_json_schemas.php $ php tools/verify_commerce_contracts.php $ php tools/release_gate_connectors.php --require-signatures

Napíšte prvú na skutočný nevýrobný účet s --live-settings=/secure/test-acme.jsonKým ste stále sťažovať, vymeniť posledný za --unsigned-ok: to sa považuje za chýbajúci podpis ako očakávané varovanie, skôr než predstierať, že je v poriadku.

04 · Obchody.json

Deklarácia toho, čo môžete predať je súbor, nie registrácia.

Konektor, ktorý môže predávať deklaruje, ktoré z vlastné odpoveď operácií OpsIQ je kanonické obchodné roly. Prítomnosť súboru je nárok. Objaví sa v nastavení predaja vo chvíli, keď vyhlási a zmizne, keď prestane. Neexistuje žiadny zoznam, ktorý by sa mohol pripojiť a nikto sa ho nepýtal.

kanonická úloha commerce_roles.json Vaša operácia
catalog_search READ acme_search_products Ok. order_get READ acme_get_order Ok. order_create WRITE acme_create_order recovery: acme_get_order order_create WRITE db_insert_record generický záznam, žiadne zotavenie
ZAMIETNUTIA

Kánonické písať role mapovaný na generický záznam písať. Zápas je štrukturálna: úložné podstatné meno vedľa mutating slovesá, bez ohľadu na vaše pomenovanie konvencie. Písanie obchodného radu priame preskočí cenu platformy, dostupnosť uzamknutie a potvrdenie pošty, a produkuje objednávku obchodný systém len polovica verí v. Nie recovery Tiež by sme mali byť neobjaviteľní.

commerce_roles.jsonVALID
{
  "commerce": {
    "roles": {
      "catalog_search": { "operation": "acme_search_products", "transport": "http" },
      "order_get":      { "operation": "acme_get_order",       "transport": "http" },
      "order_create":   { "operation": "acme_create_order",    "transport": "http",
                         "recovery":  "acme_get_order" }
    }
  }
}
Vlastný súbor naschvál: connector_contract.json je generovaný a jeho schéma súbory additionalProperties:falseTakže ručne schválený blok by zlyhal v overení a potom by bol prepísaný na ďalší generátor.
01
Uzavretý slovník

Úloha, ktorá nie je CommerceRole neexistuje. OpsIQ nikdy nepreferuje jednu z názvu operácie, pretože meno nie je sľubom.

02
Vaša vlastná akcia

Operácia sa musí zobraziť vo Vašom actions.json. Vyhlasovanie, ktorý neexistuje sľubuje zákazníkovi niečo, čo potom nič nevyprodukuje.

03
Writes deklarate recovery

Najnebezpečnejší čas je ten po platforme už možno urobil prácu. Bez nesmrteľné "did my write land" hľadať, jediné možnosti sú znovu slepý alebo stratiť objednávku.

04
Platobné roly potvrdzujú

Akákoľvek platobná úloha tiež vyhlasuje payment_profile s životné prostredie, webhook_verify používanie vlastného systému poskytovateľa a event_mapNenápadné prostredie je spôsob, akým poskytovateľ testovacieho režimu prijíma živú platbu.

Staviteľ potvrdzuje tieto ako vy typ a overovateľ potvrdzuje dodávaný balík. Obe nazývajú rovnaké funkcie, takže nemôžu nesúhlasiť.
⚖️ Ako to porovnáva

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
Scopeed Beader API + HMAC-signed webhooks Ručne valcované
Suchý beh píše + 24-hodinový úspešný opakovaný záznam DIY
1m→5m→30 m→ 2h → 12hVýhrady DIY fronty
Register akcií-zmluvných vzťahov (AI nemôže vymyslieť hovory)
Potvrdzovacia politika pred vedľajšími účinkami
Stabilný chybový obal + ID žiadosti Ručná protokolácia
Priame HTTP + generované možnosti klienta Napíš si vlastný
OpenAPI 3.0.3 strojom čitateľná zmluva Možno.
Staviteľ + brána na uvoľnenie balíka Zostrojiť reťaz na náradie
Kľúče s rozlíšením pracovného priestoru a hodinové limity Vary
Konektor vzor: kód platformy zostane izolovaný
Často kladené otázky

otázky vývojárov, odpovedal.

Autentifikácia, zmluvy, retries, generovanie klienta, bezpečné testovanie a konektor model, pred prvou žiadosťou o výrobu.

Všeobecné API odosielanie hovorov Authorization: Bearer opq_…. Kľúče môžu byť neobmedzené, obmedzené alebo len na čítanie, majú najmenej-privilege rozsahy, poslúchať hodinový limit a môže byť pripnutý do pracovného priestoru. Webhook podpis je samostatný: odchádzajúce dodávky vykonávať X-OpsIQ-Signature, X-OpsIQ-Timestamp, X-OpsIQ-Event a X-OpsIQ-Delivery.
Nie. UI môže navrhnúť len operácie uvedené v akčnom registri. Každá vygenerovaná zmluva deklaruje rozsah pôsobnosti, požiadavky polia, riziko a politiku potvrdenia; operácie, ktorých politika vyžaduje potvrdenie povrchu ľudského prehliadača pred vykonaním.
Znovu zostaviť hash_hmac('sha256', $rawBody, $secret) a porovnať jeho hexadecimálny digestor s X-OpsIQ-Signature použitie hash_equalsOveriť X-OpsIQ-Timestamp v rámci vášho prehrávania a používania X-OpsIQ-Delivery ako identifikátor vysledovateľného dodania.
Neúspešný pokus vstupuje do frontu dodávky na pozadí. OpsIQ •1- Minúta, 5- Minúta, 30- Minúta,2- hodiny a 12- hodinový rebrík pri zachovaní identifikátora dodávky a pokus o históriu diagnostiky.
Zavolajte JSON Akčný povrch priamo, importovať generovaný Pošman kolekcie, alebo generovať klienta z OpenAPI 3.0.3. PHP referenčných odosielateľov a uzol / Python integrácie klientov podporujú udalosti a toky webhook; oni sú pomocníci skôr než oddelenéAPI zmluvy.
Použitie dry_run na akciách, ktorých vytvorená zmluva podporuje, spustite skúšku pripojenia Connector Builder je ohraničený, skontrolujte jeho generované súbory, a prejsť balíček zhody a uvoľnenie brány pred ošetrením konektora ako pripravený.
Inštalované uvoľnenie generuje jeho API a zmluvy o konektoroch z vlastných registrov. Vaše nasadenie vlastní svoju verejnosť URL, tajomstvá, skladovanie a Cron / robotníci, takže správanie by malo byť overené proti nainštalovanej uvoľnenie skôr než predpokladať z cloud prostredia.
konektor je riadený balík obsahujúci adaptér, settings.json, voliteľné actions.json, generovaná kapacita zmluva, dokumentácia a voliteľné rozšírenia podniku. Šesťstupňový staviteľ ju zhromažďuje; register ho objavuje; zhoda a uvoľnenie brány potvrdiť.