Kehittäjäalusta · General API · webkoukkuja · liittimet

Tee alustasta Tekoälyä voidaan käyttää.

Call 2,418 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.

Hanki API avain Lue asiakirjoja OpenAPI-sopimus

Laaja-alaiset karhunäppäimet2,418 contract actionsOpenAPI 3.0.3 + PostinkantajaHMAC-verkkokoukkutoimitus

Laaja-alainen pyyntö

Allekirjoitettu webhook out → 200 Hyvä on.

Elävät

2,418nimetty General API toimet

69Vähiten privileg-koostumukset

dry_runvalidoi kirjoitussopimukset ennen niiden täytäntöönpanoa

24hOnnistunut idemotentti-kirjoitus uusinta

Pyynnön kesto

- Pyydän. -Ei.

Jälkeenpäin /api/v1.php jossa on tarkkailtu Karhu-avain. OpsIQ nastaa työtilan, validoi toimintasopimuksen ja oikeudet, sitten suorittaa tai kuivajuoksuttaa sen. Merkityt kanoniset tapahtumat lähtevät kautta HMAC-allekirjoitettu toimitusjono jäljitettävissä yrityksiä ja rajoittaa retries.

HMAC-SHA256 webkoukkua - saapuvat ja lähtevät webkoukku hyötykuormat on allekirjoitettu yli raa'an kehon API soittoäänet ovat aitoja, ja niillä on tarkkailtu Karhu-avain.

Automaattiset uudelleenkäsittelyt - Epäonnistuneet toimitukset peruvat ja yrittävät uudelleen.

Toista-turvallinen kirjoittaminen - onnistunut idemotentit kirjoittaa palauttaa saman vastauksen 24 tuntia; samanaikaiset kaksoiskappaleet jakaa yhden vaatimuksen.

01 Karjankarjanhoitopyyntö 02 pin-työtila 03 validoi sopimus 04 Suorita tai kuivajuoksu 05 jono allekirjoitettu tapahtuma

Pikakäynnistys

Avaimesta kotoutumisen hallintaan kolme askelmaa.

Anna vähiten privilege avain, löytää luotu sopimus, kuiva-ajo kirjoittaa, sitten tilata webkoukku, kun sovellus tarvitsee taustatapahtuman toimitus.

SopimuskonsoliYhdistetty

Suoritadread_run → hyväksytty kirjoitus, sama sopimus

Hae avain.

Rekisteröidy ja luo tähystetty karhu API avain (opq_…) kehittäjän asetukset, ja antaa jokaiselle integraatio vain pinnat se tarvitsee.

Etsi ja validoi

Lue meta.actions, meta.action sekä meta.scopes; käyttö dry_run vahvistaa kirjoittaa ennen teloitusta.

Suorita & tilaus

Lisää idempotency avain kirjoittaa, sitten tilata päätepiste kanoniset tapahtumat sovelluksen tarvitset.

Miten se sopii yhteen

Yksi liitinkuvio. Viisi puhdasta alkuasukasta.

Kaikki alustakohtainen elää liittimessä. OpsIQ Ydin pysyy geneerisenä, tekoäly pysyy ennustettavana ja integraatio pysyy tarkastettavissa.

Liipaisimet

Kerro OpsIQ Mitä juuri tapahtui.

Emit kanoniset tapahtumat alustaltasi tai määrittää hallitun mukautetun tapahtuman. Tilaajat saavat tapahtuman rekisteröityjen prioriteetti- ja toimitussääntöjen kautta.

Tapahtuman viite

Universaalit ja mukautetut tapahtumatinvoice.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ä.

02 / Toimintasopimukset

Kerro OpsIQ mitä tekoälyllä on lupa tehdä.

Jokainen nimetty operaatio saa aikaan sopimuksen: laajuus, ominaisuus, luku- tai kirjoituslaji, riski, vahvistuskäytäntö, pyyntö ja vastaus skeema, kuivajuoksutuki, idempotency ja vakaat virheet.

Toimintakaavio

Tekoäly ei osaa keksiä tekoja.Se voi pyytää vain rekisteröityjä. VahvistuspolitiikkaRiskienhallinta laukaisee esikatselukortin ennen sivuvaikutusta. Rooli + pinta-aitaJokainen toiminta ilmoittaa roolit ja pinnat sallittu ajaa sitä.

luotu toimintasopimus · 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 / Allekirjoitetut verkkokoukkuja

Työnnä tapahtumia pino - salaus todiste.

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.

Toista suojausJäljitettävissä oleva toimitustunnus5-step back-off

Webkookin viite

todentaa webkoukku - 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

Käytä suoraa HTTP tai luoda asiakas haluat.

Koko kenraaliAPI on julkaistu OpenAPI:nä 3.0.3 ja Postman. PHP reference lähettäjät plus Node ja Python integraatio asiakkaat kattavat allekirjoitettu tapahtuma ja webkookin virrat; mikä tahansa pino voi kutsua samaa JSON Toimintapinta suoraan.

asiakasesimerkkejä

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.",
    },
)

Suora JSON HTTPOpenAPI3.0.3PostinkantajakokoelmaKotouttamisen tukijat

05 / Liittimen kuvio

-Ei, vaan näppäile.

Yhdistäjä on hallittu paketti, joka on luotu tai tuotu Identity, Auth, Test, Toiminnot, Triggers ja Review. Sen ilme ilmoittaa kyky pinnat OpsIQ Saan paljastaa.

Avaa kuusivaiheinen rakentaja

Kuusi opastettua vaihettaIdentiteetti, Auth, Test, Toiminnot, Triggers ja Review pitää pakettien generation selitettävissä. Sopimusperusteinen8 profiles and 57 capability types declare the surfaces a package implements. tms.Turvallisuuden, alkuperän ja vaatimustenmukaisuuden tarkastukset tehdään ennen kuin pakkaus käsitellään valmis.

Aikomuksesta turvalliseen toimintaan

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

- Sopimus tehty. Tekoäly ehdottaa vain rekisteröimiäsi toimia.

Vahvista ennen sivuvaikutuksia. Riskienhallinta on ensin esikatselukortti.

Täysin muistan. Jokainen nopea, vastaus ja toiminta johtaa vangittu tekoälyn historia.

Katso toimintakaaviota

4 askeletaie → tilintarkastus

HMACallekirjoitettu ennen suoritusta

Ei keksitty puhelujaainoastaan sopimusrekisteri

Vahvistettuesikatselu ennen sivuvaikutuksia

Pyyntöjä koskeva jälkitoimija + sopimus + tulos

Viite

API pinta -Ei, vaan silmäyksellä.

One JSON POST surface exposes 2,418 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 viite

ToimintoAutKirjoitusturvallisuusRaja

Kirjoita toimintojaPOST /api/v1.php · sopimus validoitu

ACTION tickets.replytickets.writedry_run + idemponencyMuokkaa / tunti

ACTION security.reportsecurity.writedry_run + idemponencyMuokkaa / tunti

ACTION platform.routes.writeylläpitovahvistus + avainMuokkaa / tunti

Lue & löydön toiminnotSama POST-pinta · vakaat vaipat

ACTION meta.actionsJulkinen löytöVainMuokkaa / tunti

ACTION tickets.listtickets.readVainMuokkaa / tunti

ACTION connectors.listconnectors.readVainMuokkaa / tunti

PeopleOS HR -toimetKäärme hr.* sopimukset · hr.read / hr.write Soveltamisala

ACTION hr.people.listhr.readVainMuokkaa / tunti

ACTION hr.people.createhr.writedry_run + idemponencyMuokkaa / tunti

ACTION hr.org.treehr.readVainMuokkaa / tunti

PeopleOS HR ei lähetä uloskirjattuja HR-verkkokoukkutapahtumia. Tavoita se saman POST-pinnan kautta tai tilaa tapahtumat muista moduuleista. PeopleOSAPIja liittimet ja PeopleOS-osio kehittäjän viitteessä. Moduuli on oikeus aidattu, joten avain ilman hr Hän saa hylätyn, ei tyhjän listan. Mitä PeopleOS HR on.

Rate rajat on määritetty avainta kohti tuntiikkunassa. X-RateLimit-Limit, X-RateLimit-Remaining sekä X-RateLimit-Reset; hylätty pyyntö palauttaa 429 kun Retry-After. Käytä OpenAPI 3.0.3 sopimus tai Postinkantajakokoelma jotka on tuotettu samoista ajoaikarekistereistä.

Koosta liitin

Koosta, testaa ja vapauta kuusi vaihetta.

Aloita ohjatusta profiilista tai määritä sopimus itse. Rakentaja validoi jokaisen vaiheen ennen kuin se luo itsenäisen liitinpaketin.

1Henkilöllisyys. Nimi, etana, profiili ja ilmoitetut toimintakyvyn pinnat.

2Auth. API Avain, Karhu, Basic OAuth 2.0, HMAC tai asiakas.

3Testi. Validoidaan rajatut yhteysasetukset ennen pakkaamista.

4- Tekoja. Kartta nimetty toiminnot, parametrit, soveltamisalat ja riski.

5-Lähteitä. Ilmoita saapuvat tapahtumat, webkoukkuja, kyselyt ja synkkä käyttäytyminen.

6Uudelleentarkastelu. Tutkikaa sopimus ja ohittakaa vapautusportti.

Kokeile ennen kuin lähetät

Validoidaan turvallisesti ja sitten ohitetaan portti.

Käyttö dry_run Tukee kirjoittaa toimia, suorita Builder's rajoitettu yhteys testi, ja tarkastaa luotu manifesti ja sopimus ennen julkaisua. Paketti validointi tarkistaa valmiudet nimet, asetukset, lähtöisyys ja vaaditut tiedostot; taustatyöntekijät käsittelevät reaktiivinen kyselyt ja lähtevä toimitus.

Kuivaajon kirjoittaminen Sidotun kytkennän testi Sopimuksenmukaisuus Cron-käyttöinen toimitus

Avaa liitinrakenne Webkookin viite

liitin. php · php

luokka AcmeConnector Laajennukset AbstractConnector { julkinen tehtävä Emakko(): merkkijono { palautus 'akme'; } julkinen tehtävä nimi(): merkkijono { palautus Acme.; } julkinen tehtävä kuvaus: merkkijono { palautus 'Acmen silta'; } // Käytä ConnectorConnector Connectin nimiä julkinen tehtävä ominaisuudet: matriisi { palautus ["toimet", 'webkook']; } julkinen tehtävä asetuksetSchema(): matriisi { palautus [['avain' => 'Token', 'tyypillä' => 'salasanalla']]; } julkinen tehtävä TestiKonnection(matriisi $settings): matriisi { palautus ["menestys" => tosi]; } julkinen tehtävä kahvaWebhook( matriisi $payload, matriisi $headers, matriisi $settings ): matriisi { palautus ["menestys" => tosi]; } }

01 · Connector contract 2.4

Paketti ei voi vaatia kykyä Sen koodia ei ole.

OpsIQ\Connectors\ConnectorContract Runtime löytö, rakentaja, ensimmäisen osapuolen paketteja, conformance, kenraali API ja jokainen viittaus lukee, että yksi rekisteri. Julista kyky ja kolme tiedostoja on sovittava keskenään ennen OpsIQ Reittiä yksi rivi sinulle.

FIG. 01liitinpaketti, osat ilmentymä scale 1:1 · contract 2.4

01 connector.php ajoaikaluokka
02 IdentityProvider.php vakaa ulkoinen avain
03 SalesIngest.php socécéleSales()
04 actions.json nimetyt toiminnot
05 settings.json Operaattorin konfiguraatio
06 connector_contract.json koneellisesti luettava viranomainen

07 signature.json yksi HMAC SHA:n takia256 jokaisesta edellä olevasta tiedostosta sekä ed25519-alkuperätodistus

Voimakkuusmatriisi all 57, as registered

toimet laukaisimet webkookki journey_events tausta guest_lookup henkilöllisyyttä sales sales_reconciliation Laskutus payments kauppa 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 crm block_registry inbound_comment outbound_note outbound_notification oauth reviews paikallinen se site_intelligence analytiikka comms admin_assets enterprise_hooks durable_queue ticket_mirror attachment_bridge database_migrations scheduled_workers conflict_resolution

tuotettu 30 declaratiivinen 20 Laajentaminen 7

Kaksi allekirjoitusta, kaksi kysymystä.

hmac-sha256 per-file SHA-256 hashes an deterministinen hyötykuorma on muutettu allekirjoittamisen jälkeen. An ed25519 allekirjoitusvastaukset Allekirjoittiko se Nabtech, tarkistaa kanssa nippu julkinen avain ja ei jaettu salaisuus. Muokkaa yksi tavu ja ensimmäinen pysähtyy vastaavuutta.

marketplace.json ei ole allekirjoituksen määritelmän mukainen: asentaja kirjoittaa sen allekirjoittamisen jälkeen, joten kustantaja ei olisi voinut allekirjoittaa sitä.

02 · työkalut/mutaatio_proof.php

Vartija, joka ei ole koskaan epäonnistunut -Ei ole todistettu.

Vihreät testit eivät kerro, että kirjoittamasi vartija pysäyttäisi sen, - koska vartija, jota ei ole koskaan käytetty, kulkee kuin vartija joka ei tee mitään.

vartija · lukutehtävän on kieltäydyttävä tuhoavasta toiminnasta CH1 verify_commerce_contracts

src/Connectors/CommerceRoleMapVerifier.php MUUTTUNEET

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    }

- Juuri niin. yksi Ei otteluita, eikä todisteita.

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

Epäonnistunut todiste on koskaan Sekin virhe ei todista, että vartija toimii.

Mutaatio ei koskaan levinnyt.

Hakuteksti ei täsmää, tiedosto oli koskematon, sviitti läpäisi ja todiste tallentui vihreä vanhan koodin alla Se ei ollut koskaan vanhaa koodia.

Mutaatio rikkoi jotain muuta.

Sviitti muuttui punaiseksi, koska tiedosto lakkasi tulkitsemasta tai saappaat kuolivat. nimetty testi epäonnistumisten joukossa.

Se ei voi jättää mutanttia levylle.

Jokainen mutaatio kopioi alkuperäisen sivuvaunuun web-palvellun puun ulkopuolella, kirjoittaa merkkijonon, joka nimeää jäljellä olevan muutoksen ja jonka sammutusohjaaja tekee jokaiselle uloskäynnille. Tuhoutuneesta ajosta saatu merkki on otettu huomioon ennen tiedoston seuraavaa mutaatiota.

03 · Yhteensopivuus

Sertifiointi on komento ja poistumiskoodi.

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/ kattaa asetukset, toimet, Builder specs, matka-ja kaupan tapahtumakartoituksia, työnkulun reseptejä, liitin sopimukset ja julkaisu manifestit.

manifests jäsennelkää ja sopikaa keskenänne
valmiudet on olemassa ajoaikaluokassa
interfaces toteutetaan, kun on ilmoitettu
files kaikki vaaditut tiedostot läsnä
toimet ottelua toimintoluettelossa
destructive vahvistus
henkilöllisyyttä vakaa ulkoinen avain, ei sähköposti
uusinta toistopäivitykset, eivät koskaan kaksoiskappaleet
Yritys ilmoitukset vastaavat laajennusta
dokumentit READ, DEVELOPER, MUUTOKSET
skeemat joka JSON validoi

exit 0 acme: conformant against contract 2.4 Epäonnistunut sviitti nimeää shekin ja tiedoston.

$ 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

Osoita ensimmäinen todellinen ei-tuotantotili --live-settings=/secure/test-acme.json. Kun olet vielä itkemässä, vaihtaa viimeinen --unsigned-ok: se kohtelee puuttuvaa allekirjoitusta pikemminkin odotettavissa varoituksena kuin teeskentelee, että se on kunnossa.

04 · Kaupan_ roolit.json

Selostaminen mitä voit myydä on tiedosto, ei rekisteri.

Liitos, joka voi myydä ilmoittaa mitä oma toiminnoista vastaa OpsIQ:n kanoninen kaupankäyntiroolit. Tiedoston läsnäolo on vaatimus. Se näkyy myyntiasetuksissa heti kun se ilmoittaa ja katoaa, kun se pysähtyy. Ei ole listaa liittyä eikä kukaan kysyä.

kanoninen rooli commerce_roles.json operaatio

EPÄÄMINEN

Kanoninen kirjoittaa rooli on suunniteltu yleiseen tietueeseen. Ottelu on rakenteellinen: varastointi substantiivi mutatoivan verbin vieressä, mikä tahansa nimityskäytäntösi. Business-rivin kirjoittaminen suoraan ohittaa alustan hinnoittelun, käytettävyyden lukituksen ja vahvistuksen postin ja tuottaa tilauksen, johon kauppiaan oma järjestelmä vain puolet uskoo. recovery -Ei. Aikalisää ei voi palauttaa.

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" }
    }
  }
}

Sen oma tiedosto tarkoituksella: connector_contract.json on tuotettu ja sen schema asetetaan additionalProperties:false, joten käsin tehty lohko siellä epäonnistuisi validointi ja sitten ylikirjoitetaan seuraavan generaattorin ajaa.

Suljettu sanasto

Ei rooli CommerceRole ei ole olemassa. OpsIQ ei koskaan päätä sellaista operaation nimestä, koska nimi ei ole lupaus.

Oma toimintasi

Operaation täytyy näkyä actions.json. Ilmoittaminen sellainen, jota ei ole olemassa lupaa asiakkaalle jotain, joka sitten tuottaa mitään.

Kirjaukset ilmoittavat perinnän

Vaarallisin aikalisä on se, kun alusta on jo ehkä tehnyt työn. Ilman idemotentti "kuollut kirjoittaa maata" etsiä, ainoa vaihtoehto on yrittää uudelleen sokea tai menettää järjestyksessä.

Maksuroolit

Kaikki maksuluokan tehtävät ilmoitetaan myös payment_profile ja Ympäristö, webhook_verify palveluntarjoajan oman järjestelmän käyttäminen, ja event_map. Tekstaamaton ympäristö on se, miten testi-moodi tarjoaja ottaa suoran maksun.

Rakentaja vahvistaa nämä kirjoittamallasi tavalla ja todentaja vahvistaa lähetetyn paketin. Molemmat soittavat samoihin toimintoihin, joten he eivät voi olla eri mieltä.

⚖️ Miten se vertaa

OpsIQ vs - 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
Laajakarhu API + HMAC-allekirjoitetut webkoukkuja	muut, poikkileikkaukseltaan ympyrän muotoiset	✓
Kuivajuoksun kirjoittaminen + 24- tunnin onnistunut uusinta	KUOLE	✓
1m→5m→30m→ 2h → 12hretriesCity in Ontario Canada	DIY-jono	✓
Toimintasopimusrekisteri (AI ei voi keksiä puheluja)	—	✓
Vahvistuspolitiikka ennen sivuvaikutuksia	—	✓
Tilan virhekuoren ja pyyntötunnisteiden	Manuaalinen kirjautuminen	✓
Suora HTTP + luodut asiakasvalinnat	Kirjoita omasi	✓
OpenAPI 3.0.3 koneellisesti luettava sopimus	Ehkä.	✓
Kuusivaiheinen rakentaja + pakettien vapautusportti	Koosta työkaluketju	✓
Työtilan näppäimistö ja tuntirajat	Vaihtelee	✓
Liittimen kuvio: alustakoodi pysyy eristyksissä	—	✓

UKK

Kehittäjän kysymykset Vastasit.

Tunnistaminen, sopimukset, retries, asiakastuotanto, turvallinen testaus ja liitinmalli, ennen ensimmäistä tuotantopyyntöä.

Yleistä API puhelut lähetetään Authorization: Bearer opq_…. Avaimet voivat olla rajoittamaton, rajoitettu tai luku-vain, kuljettaa vähiten privilege soveltamisalat, noudattaa tunnin raja ja voidaan kiinnittää työtilaan. Webkook allekirjoitus on erillinen: lähtevät toimitukset kuljettaa X-OpsIQ-Signature, X-OpsIQ-Timestamp, X-OpsIQ-Event sekä X-OpsIQ-Delivery.

Ei. Tekoäly voi ehdottaa vain nimettyjä toimintoja toimintarekisteriin. Jokainen luotu sopimus ilmoittaa soveltamisalan, pyyntökentät, riski-ja vahvistuskäytäntö; operaatiot, joiden politiikka edellyttää vahvistus pinnalla ihmisen esikatselu ennen täytäntöönpanoa.

Täytä hash_hmac('sha256', $rawBody, $secret) ja verrata sen heksadesimaalin sulatus X-OpsIQ-Signature käytetään hash_equals. Validoidaan X-OpsIQ-Timestamp sisällä replay ikkunan ja käyttää X-OpsIQ-Delivery jäljitettävänä toimitustunnisteena.

Epäonnistunut yritys tulee taustatoimitusjonoon. OpsIQ Euroopan parlamentti hyväksynyt 16. maalis kuuta.1- Hetki. 5- Hetki. 30- Hetki.2- tunti ja 12-Tikkaat tuntien ajaksi.

Soita JSON toimintapinta suoraan, tuoda luotu Postman kokoelma, tai luoda asiakas OpenAPI 3.0.3. PHP referenssi lähettäjät ja Node / Python integraatio asiakkaat tukevat tapahtumaa ja webkookin virtoja; ne ovat auttajia eikä erillisiäAPI sopimukset.

Käyttö dry_run Teoista, joiden luoma sopimus tukee sitä, suorita Connector Builderin rajoitettu kytkentätesti, tarkasta sen luodut tiedostot ja läpäise pakkauksen conformance- ja vapautusportit ennen kuin käsittelet liitintä valmiina.

Asennettu julkaisu tuottaa sen API ja liitäntöjä omista ajoaikarekistereistään. URL, salaisuudet, varastointi ja Cron / työntekijät, joten käyttäytyminen olisi tarkistettava verrattuna asennettuun julkaisu pikemminkin kuin olettaa pilviympäristössä.

liitin on ohjattu pakkaus, joka sisältää adapterin settings.json, vapaaehtoinen actions.json, luotu kykysopimus, dokumentaatio ja valinnaisia yrityksen laajennuksia. Kuusivaiheinen rakentaja kokoaa sen; rekisteri löytää sen; conformance ja julkaisu portit validoivat sen.