Geliştirici platformu · General API · webhooks · konektörler

platformunuzu yapın Yapay zeka ile çalışabilir.

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

Kapsama Ayılar Anahtarları2,420 contract actionsOpenAPI 3.0.3 + PostmanHMAC webhook teslimat
Kapsama talep
Kayıt edilen webhook out → 200 Tamam
Derece Ayıer aksiyon → OpsIQ → webhook imzalamıştır POST /api/v1.php Authorization: Bearer { "action": "tickets. reply", "kurum": true } · RUN · ÖvÇ anahtar + çalışma alanı ✓ kapsamı + sözleşme ✓ İzinli istek Webhook uç noktası X-OpsIQ- Event: bilet. replied HMAC → iş 200 Tamam
2,420General API eylemleri
69En az-privilege kapsamı
dry_runUygulama sözleşmelerini yürütmeden önce doğrulamadan önce
24sBaşarılı idempotent-write replay
İstek hayat döngüsü

Kapsama talep. Oturuma kaydolun.

POST Bir Eylem /api/v1.php Bir kapsa anahtarı ile. OpsIQ iş alanı pins, eylem sözleşmesini ve izinlerini doğrular, sonra bunu yürütür veya kuru-runlar. Abone olarak, HMAC tarafından belirlenen bir teslimat kuyruğundan takip edilebilir girişimler ve bağlı yeniden kurulabilir.

HMAC-SHA256 web hook'ları - inbound ve outbound webhook ödeme yükleri ham vücut üzerinde imzalanır; API, bir kapa anahtarı ile otantik çağrılar çağırır.
Otomatik yenidenrries - başarısız teslimatlar geri döndü ve yeniden deneme, bir teslimat kimliği ile izleyebileceğiniz.
Replay-güvenli yazar - Başarılı idempotent, 24 saat için aynı cevabı döndürür; eş zamanlı replikler bir iddia paylaşır.
Uygulamanız POST /api/v1.php Authorization: Bearer idempotency_key: idem_31c7 GÜVENLİK - YÜRÜT - DENETLEME Sizin uç noktanız POST /webhooks HMAC'yi doğrulama 200 Tamam anahtar + iş alanı pinnedildi kapsamı + rol kontrol Sözleşme doğrulamalı Uygulama veya kuru-run SED WEBHOOK DÜŞ { X-OpsIQ-Event: bilet. replied X-OpsIQ-Delivery: dlv_8f2a9 X-OpsIQ-Timestamp: 1786584362 X-OpsIQ-Signature9c4e0a7b... } teslim edildi
01 Ayıer istek 02 pin workspace 03 Sözleşme doğrulama 04 Uygulama veya kuru-run 05 kuyruk imzalanmış olay
Hızlı başlangıç

En önemliden entegrasyon Üç adım.

En az kardi bir anahtar sorun, üretilen sözleşmeyi keşfedin, kuru-bir yazıyı takip edin, sonra uygulamanızın arka plan etkinliği teslimatına ihtiyaç duyduğunda bir webhook abone olun.

Anlaşma konsoluBağlanmış
GENEL API · sözleşmeli 1 · Genrate key opq_live_xxx · bir kapalı Ayırma anahtarı 2 · Sözleşmeleri Keşfetmek POST /api/v1.php · meta. actions 3 · Bir yazıyı doğrulama Biletler. reply · kuru_run: gerçek 4 · olaylara abone olun bilet. replied · HMAC teslimat
YürütKuru_run → onaylı yazı, aynı sözleşme
01

Bir anahtar alın

Kayıt olun ve bir kapsamın Ayıer API anahtar (YouTube)opq_…Geliştirici ayarlarında ve her entegrasyona sadece ihtiyaç duyduğu yüzeyler verir.

02

Discover & Valid

Read Oku meta.actions, meta.action ve meta.scopes· kullanım dry_run Uygulamadan önce yazı doğrulamak için.

03

Execute & abone

Yazı için bir idempotency anahtar ekleyin, sonra uygulamanızın ihtiyaç duyduğu kanonik olaylara son noktanızı abone edin.

Nasıl birlikte uyuyor

Bir konektör modeli. Beş temiz ilkel.

Bir bağlantıda belirli bir platforma özel yaşamlar. OpsIQ çekirdeği genel olarak kalır, AI öngörülebilir kalır ve entegrasyonunuz denetimlenebilir kalır.

01
Tetikleyiciler

OpsIQ ne oldu.

Emit canonical events platformunuzdan veya yönetilen bir özel olay tanımlamak. Aboneler etkinlik kayıt dışı öncelik ve teslimat kuralları aracılığıyla alır.

Event referans
invoice.paid Canonical event Artırılmış beyinCanlı bağlam kurallar kuralları kurallarönceliği 20 aynaİlk önce yaz webhookimzalanmış
Universal + özel olaylarinvoice.paid, ticket.created, subscription.cancelled, customer.signed_up veya kendi. Fan-out aboneleriAI beyni, otomasyon kuralları, ayna konektörleri ve webhook uç noktalarınız tüm tepki verir. Öncekilik düzeniDeterministic, bu kadar aynalar uyarıları ateşten önce yazmaktadır.
02 / Action kontratları

OpsIQ AI'nın ne yapmasına izin verildiğine söyle.

Her isim işlemi bir sözleşme alır: kapsamı, özellik, okumak veya yazmak, risk, onay politikası, istek ve cevap şeması, kuru temizleme desteği, idempotency ve stabil hatalar.

Action şema
AI eylemleri icat edemezSadece kayıtlı olduğunuz şeyleri çalıştırmanızı isteyebilir. Onay Politika PolitikasıRisk eylemleri herhangi bir yan etkilerden önce bir önizleme kartı tetikler. Rol + yüzey gatingHer eylem, roller ve yüzeylerin bunu çalıştırmasına izin verdiğini söylüyor.
Oluşturulan aksiyon sözleşmesi · 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 / İmzalanmış webhooklar

Taklitlerinize - kriptografik kanıt ile olayları.

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.

Yeniden tekrarlama koruma korumasıİzlenebilir teslimat ID5-step back-off
Webhook referans
Webhook'u doğrulamak - 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' lar

Doğrudan HTTP kullanın veya tercih ettiğiniz müşteriyi üretir.

Bütün GeneralAPI OpenAPI olarak yayınlandı 3.0.3 Postman. PHP referans gönderenler artı Node ve Python entegrasyon müşterileri, imzalanmış olay ve webhook akışları kapsayabilir; herhangi bir yığın aynı şeyi çağırabilir JSON Doğrudan hareket yüzeyi.

müşteri örneklerini örneklendirir
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.",
    },
)
Doğrudan JSON HTTPOpenAPI 3.0.3Postman koleksiyonBütünleşme yardımcıları
05 / The konektör pattern

Bir kez inşa edin. bir şeye tak.

Bir bağlantı, kimlik, Auth, Test, Actions, Tetikler ve İnceleme aracılığıyla üretilen veya ithal edilen bir pakettir. Açıklaması, yüzeylerin OpsIQ 'ın ortaya çıkmasına izin verilir.

Altı aşamalı Builder açın
Altı yönlendirilen aşamalarKimlik, Auth, Test, Actions, Tetikler ve İnceleme paket nesli açıklanabilir. Sözleşmeye dayalı8 profiles and 57 capability types declare the surfaces a package implements. Salı-KödülGüvenlik, kanıtlayıcı ve uygun kontroller bir paket hazır olarak muamele edilir.
Güvenli eylemlerden

İngilizce konuşuyor. Denetimli işlemler dışarı çıktı.

OpsIQ asla doğru çağrı icat etmez. Kayıtlı sözleşmeler aracılığıyla yürür, ödeme yükü hazırlar ve eylem gerektirdiğinde onay isteyin ve yürütdüğünde tam bir denetim sırasını üretir, bu yüzden bir AI bunu gerçekleştirebilir. hareket eylemi Hiçbir zaman güvenemeyeceğiniz bir AI olmaz.

Sözleşmeye bağlı. AI sadece kayıtlı olduğunuz eylemleri önerir.
Yan etkilerden önce onaylayın. Riskli eylemler ilk önce bir önizleme kartı oluşturur.
Total remember. Her hızlı, yanıt ve eylem sonucu AI History'de yakalandı.
4 adımlarıniyet → denetim
HMACimzalamadan önce imzalanmış
"refund Adam'ın son faturası" Adım 1 · niyet kararı → maça alındı: saas. refund_in bill Yüzey: yönetici · rol: sahibi · Adım 2 doğru Adım 3 · Onay ve işaret önizleme kartı · fatura #8421 Onaylandı Adım 4 · Denetim satırları Oyuncu · hızlı sonuç · 412ms Sahibi-sadece · CSV olarak ihracat yapılabilir
Hiçbir icat aramasözleşme kayıt sadece yalnızca
OnaylandıYan etkilerden önce önizleme
Lütfen izaktör + sözleşme + sonuç
Referans

API yüzey Bir bakışta.

One JSON POST surface exposes 2,420 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 referans
EylemYetkilendirmeWrite securityLimit Sınır sınırı
Yorum yaz eylemleriPOST /api/v1.php · sözleşme doğrulama
ACTION tickets.replytickets.writeKuru_run + idempotencyConfigured / saat
ACTION security.reportsecurity.writeKuru_run + idempotencyConfigured / saat
ACTION platform.routes.writeadminOnay + anahtarConfigured / saat
Oku & keşif eylemleriAynı POST yüzeyi · stabil zarflar
ACTION meta.actionsKamu keşfiSadece okuyunConfigured / saat
ACTION tickets.listtickets.readSadece okuyunConfigured / saat
ACTION connectors.listconnectors.readSadece okuyunConfigured / saat
PeopleOS HR eylemleriÖğrdüdün hr.* sözleşmeler · hr.read / hr.write kapsamı
ACTION hr.people.listhr.readSadece okuyunConfigured / saat
ACTION hr.people.createhr.writeKuru_run + idempotencyConfigured / saat
ACTION hr.org.treehr.readSadece okuyunConfigured / saat
PeopleOS HR does not send outbound HR webhook events. Reach it through the same POST surface, or subscribe to the events other modules publish. Full reference: PeopleOS API ve konektörler Ve Geliştirici referansının PeopleOS bölümü. Modül entitlement kapılı, bu yüzden bir anahtar olmadan hr Bir reddedilme alır, boş bir liste değil. İnsanlarOS HR Nedir.

Puan sınırları bir saat pencerede anahtar olarak yapılandırılır. Cevaplar ortaya çıkıyor X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset• reddedilen bir istek geri dönüşleri 429 with Retry-After. Use the OpenAPI 3.0.3 sözleşme veya Postman koleksiyon Aynı runtime kayıtlarından üretilmiştir.

Bir bağlantı kurmak

Build, test ve salıverme Altı aşama.

Bir yönetilen profilden başlayın veya sözleşmeyi kendiniz tanımlayın. The Builder her aşaması kendi kendine özgü bir bağlantı paketi oluşturmadan önce doğrulamaktadır.

1Kimlik. Ad, slug, profil ve yetenek yüzeylerini ilan etti.
2Auth. API Anahtar, Bearer, Basic, OAuth 2.0 HMAC veya özel bir müşteri.
3Test. Ambalajtan önce bağlı bağlantı ayarlarını uygulayın.
4Eylemler. Operasyonlar, parametreler, kapsamı ve risk.
5Tetikleyiciler. Haftalara, webhooks, anket ve senkronizasyon davranışları.
6İnceleme. Oluşturulan sözleşmeyi ihmal edin ve serbest bırakma kapısını geç.
Gemiden önce test edin

Güvenli bir şekilde, sonra serbest bırakılması kapısını geç.

Kullan dry_run Desteklenen yazı eylemleri üzerinde, Builder'ın bağlı bağlantı testini çalıştırın ve serbest bırakmadan önce üretilen açık ve sözleşmeyi inceler. Paket geçerlilik kontrolleri yetenek isimleri, ayarları, kanıtlanmış ve gerekli dosyaları; arka plan işçileri reaktif kirletici anket ve teslimiyetle idare eder.

Kuru-run yazıyor Bounded connection test testi Sözleşme uygunlaştırma Cron-güdümlü teslimat
Link. php · php
Sınıf sınıfı sınıf sınıfı AcmeConnector genişletilebilir genişleme uzatılabilir AbstractConnector { Halkla İlişkiler s. dize { geri dönüş geri dönüş "acme"; } Halkla İlişkiler Adı(): dize { geri dönüş geri dönüş "Acme"; } Halkla İlişkiler Açıklama(): dize { geri dönüş geri dönüş "Acme köprüsü"; } // LinkContract'dan isimleri kullanın Halkla İlişkiler yetenekleri(): dizi { geri dönüş geri dönüş [‘actions’, 'webhook']; } Halkla İlişkiler ayarlarSchema(): dizi { geri dönüş geri dönüş [['key' => 'token', ‘tip’ => 'password']]; } Halkla İlişkiler TestConnection (İngilizce)dizi $settings): dizi { geri dönüş geri dönüş ['Başarı' => doğru]; } Halkla İlişkiler İşi dizi $payload, dizi $headers, dizi $settings ): dizi { geri dönüş geri dönüş ['Başarı' => doğru]; } }
01 · Connector contract 2.4

Bir paket bir yetenek iddia edemez Onun koduna sahip değildir.

OpsIQ\Connectors\ConnectorContract Görevdir. Runtime keşif, Builder, ilk parti paketleri, uygunluk, General API Ve her referans, bir kayıt.Bir yetenek ve üç dosyanın daha önce birbirleriyle aynı fikirde olması gerektiğini okudu OpsIQ Size tek bir satır yollar.

FIG. 01Bağlantı paketi, parçalar ortaya çıkıyor scale 1:1 · contract 2.4
  1. 01 connector.php runtime class
  2. 02 IdentityProvider.php istikrarlı dış anahtar anahtarı
  3. 03 SalesIngest.php uzlaşılmaz
  4. 04 actions.json İsimli operasyonlar
  5. 05 settings.json operatör yapılandırma
  6. 06 connector_contract.json Makine hazır yetkiye sahip
07 signature.json Bir biri bir HMAC Bir SHA-A'nın üzerinde256 Yukarıdaki her dosyanın, artı kökeninin ed25519 kanıtı
Capability matrix all 57, as registered
eylemler tetikleyiciler webhook journey_events bağlam bağlamı guest_lookup kimlik sales sales_reconciliation Faturayı payments commerce 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 s block_registry inbound_comment outbound_note outbound_notification oauth reviews yerel bu site_intelligence Analitik Analiz analitik comms admin_assets enterprise_hooks durable_queue ticket_mirror attachment_bridge database_migrations scheduled_workers conflict_resolution
Oluşturulan üretilen üretilmiştir 30 açıklamalı 20 extension 7
İki imza, iki soru.

hmac-sha256 per-file SHA-256 'ın bir deterministic ödeme yükü üzerinde cevap verir Bu, imzalandığında değiştirildi. An ed25519 İmza cevaplar Nabtech tarafından imzalanmıştıAncak, paketlenen kamu anahtarı ile kontrol edilebilir ve paylaşılmaz. Biri Hazırlayın ve ilk duraklamayı durdurun.

marketplace.json Açıklama ile imza dışında: installer imza aldıktan sonra yazar, bu yüzden yayıncı bunu asla imzalamadı.
02 · araçlar /mutasyon_proof. php

Hiç başarısız olmamış bir muhafız Unproven.

Yeşil testler bugün hiçbir şey kırılmamıştır. Size yazdığınız muhafızın durdurmak için yazılmış olduğunu söylemiyorlar, çünkü asla egzersiz yapan bir gardiyan tam olarak hiçbir şey yapmamak gibi geçmiyor ve çığlıkları izlemek talep ediyoruz.

Koruma · okuma rolü yıkıcı bir operasyon reddetmeli CH1 verify_commerce_contracts
src/Connectors/CommerceRoleMapVerifier.php MUTATED
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    }
Tam olarak tam anlamıyla tam olarak tam olarak tamamen tam olarak Bir biri bir Metinsel maç gereklidir. Zero maçları veya iki ve yalan söylemeden önce kanıt duraklar.
$ 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.
Başarısız bir kanıt başarısız olan never Kayıt olun. Bir çek yanlış gittiğinin kanıtı, bir muhafızın işe yaradığı kanıt değildir.

mutasyon asla uygulanmadı.

Arama metni maç yapmadı, dosyaya alındı, süit geçti ve kaydedilen kanıt kaydedildi. Eski kod altında yeşil Asla eski olmayan kod hakkında. Tam bir metinsel maç gerektiren ve dosyanın iki tarafını karşılaştırmak için yalvarın.

mutasyon başka bir şey kırdı.

Oda kırmızıya gitti çünkü dosya parsing veya bottrap öldü ve kanıt, muhafızla hiçbir ilgisi olmayan bir kırmızı kaydetti. mutantı linting the mutant and requireing the sentences named Başarısızlıklar arasında test.

Disk üzerinde bir mutant bırakamaz.

Her mutasyon orijinali web tabanlı bir ağacın dışında bir yankara kopyalar, olağanüstü değişikliği isimlendiren bir işaret yazar ve her çıkış yolundaki bir kapanış eller tarafından geri alınır. Bir kazara koşudan gelen bir işaret bu dosyanın sonraki mutasyonundan önce onurlandırılır.

03 · Conformance

Sertifika bir komut Bir çıkış kodu ile.

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/ Kapak ayarları, eylemler, Builder specs, seyahat ve ticaret olayı haritaları, iş tarifleri, bağlayıcı sözleşmeler ve yayınlar ortaya çıkıyor.

  1. manifests parse ve birbirleriyle aynı fikirde
  2. yetenekleri yetenekler Runtime class'da var
  3. interfaces nereye ilan edildiğine dair yemin etti
  4. files Her gerekli dosya mevcut
  5. eylemler Eylemler açıkla
  6. destructive Açıklamalar
  7. kimlik istikrarlı bir dış anahtar, e-posta değil
  8. yeniden tekrar Tekrarlanan bir güncelleme, asla tekrarlar
  9. - Enterprise. Açıklamalar genişleme ile eşleştirir
  10. Docs DME, DEVELOPER, CHANGELOG
  11. şemalar Her JSON doğruları doğruluyor
Çıkış 0 acme: conformant against contract 2.4 Başarısız bir süit kontrol ve dosyayı adlandırıyor. Bunu düzeltin, değil.
$ 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

İlki gerçek üretim hesabında gerçek olmayan bir hesapta bulun --live-settings=/secure/test-acme.json. Hala iterating olsanız da, son olanı takas edin --unsigned-ok: Bu, beklenen bir uyarı olarak eksik bir imzaya sahiptir, çünkü iyi olduğu gibi.

04 · ticaret_roles.json

Ne satabileceğinizi kınamak Bir dosya, bir kayıt değil.

Hangi satabileceğini ilan edebilecek bir bağlantı its own Operasyonlar OpsIQ'in canonical ticaret rollerini cevaplıyor. Dosyanın varlığı iddia ediyor. Şu anda satış ayarlarında görünüyor ve duraklandığında yok oluyor. katılmak için hiçbir liste yok ve kimse sormaz.

Canonical role commerce_roles.json Operasyonunuzu
catalog_search READ acme_search_products tamam order_get READ acme_get_order tamam order_create WRITE acme_create_order recovery: acme_get_order order_create WRITE db_insert_record jenerik kayıt yazmak, kurtarma yok
REFUSED

Bir kanonik Yazı yazmak için yaz İş sıralaması, platformun fiyatlarını doğrudan atlar ve bildirim postasını tasarlayın ve tüccarın kendi sistemini sadece yarısına inandığı bir sipariş verin. recovery Ya da, bir süre kurtarılamazdı.

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" }
    }
  }
}
Kendi dosyasını amaç üzerinde: connector_contract.json Oluşturulur ve onun şema setleri additionalProperties:falseAncak bir el yazarlı blok geçerli olmazdı ve sonra sonraki jeneratörde yazılabilir.
01
Kapalı kelime

Bir rolde değil CommerceRole Yok. OpsIQ asla bir operasyon adından birini yapmaz, çünkü bir isim söz konusu değildir.

02
Kendi eyleminiz

Operasyon sizin üzerinizde görünmelidir actions.jsonMevcut olmayan bir kişi, o zaman hiçbir şey üretmediği bir müşteriye söz etmez.

03
Yazlar kurtarma ilanları

En tehlikeli zamanout, platformdan sonra zaten işi yapmış olabilir. idempotent "benim yazma arazim" göz önüne alındığında, tek seçenek yeniden deneme körü veya siparişi kaybeder.

04
Ödeme rolleri certify

Herhangi bir ödeme sınıfı rolü de aynı zamanda ilan payment_profile ile birlikte environment, webhook_verify Sağlayıcının kendi planını kullanarak ve event_map. Devletsiz bir ortam, test-mode sağlayıcısının canlı bir ödeme yapması nasıldır.

Builder bunu sizin türüniz olarak doğrular ve bu da gönderilen paketi onaylar. Her ikisi de aynı işlevleri çağırır, böylece aynı fikirde değiller.
⚖️ Nasıl karşılaştırılır?

OpsIQ a karşı DIY entegrasyonu.

Bir sözleşmeye sahip olan ne, imzalanmış, denetimli platform size kendi webhooks ve AI-action tesisatınızı asla taşımadığını verir.

YetenekliKendin kendi kendine yuvarlayınOpsIQ
Kapsamd Bearer API + HMAC-signed webhooks El-rolled
Kuru-run + 24-hour Başarılı Replay DIY
1m→5m→30m→ 2h → 12hYeniden tekrarlamalar DIY kuyrukları
Action-job records (AI aramaları icat edemez)
Yan etkilerden önce politikayı onaylayın
Stable error zarf + istek IDs Manual log
Doğrudan HTTP + oluşturulan müşteri seçenekleri Kendin Yaz
OpenAPI 3.0.3 makine hazırlanabilir sözleşme Maybe
Six- stage Builder + paket salım kapısı Bir aletchain inşa edin
Workspace-pined anahtarları ve saat sınırları Varies Var
Links: platform kodu izole kalır
SSS

Geliştirici soruları, Cevap verdi.

Kimlik, sözleşmeler, yeniden kayıtlar, müşteri nesli, güvenli test ve bağlantı modeli, ilk üretim talebinden önce.

General API aramalar gönder Authorization: Bearer opq_…Anahtarlar, yalnızca sınırlı veya okunabilir, en az kardigi kapsamı taşıyabilir ve bir saat sınırına itaat edebilir ve iş alanına onaylanabilir. Webhook imzası ayrı: dolma teslimatları tamamlandı X-OpsIQ-Signature, X-OpsIQ-Timestamp, X-OpsIQ-Event ve X-OpsIQ-Delivery.
Hayır. AI sadece eylem kayıt defterinde işlemleri önerebilir. Her bir üretilen sözleşme kapsamı, istek alanları, risk ve onay politikası; politikayı onaylamadan önce insan önizlemesini gerektiren operasyonlar.
Yeniden hesapla hash_hmac('sha256', $rawBody, $secret) Ve hexadecimal sindirini onunla karşılaştır X-OpsIQ-Signature using hash_equals. Validate X-OpsIQ-Timestamp Yeniden oyun penceresinizde ve kullanımınızda X-OpsIQ-Delivery İzlenebilir teslimat tanımlayıcısı olarak.
Yeterli olmayan bir girişim arka teslimat kuyruğuna girer. OpsIQ Yeniden ziyaretler1- dakika, 5- dakika, 30- dakika,2- Saat ve 12- teslimat tanımlayıcısını korurken ve tanılar için tarih deneyin.
Call the JSON action surface directly, import the generated Postman collection, or generate a client from OpenAPI 3.0.3. PHP reference senders and Node/Python integration clients support event and webhook flows; they are helpers rather than separate API contracts.
Kullan dry_run Oluşturulan sözleşme onu destekleyen eylemlerde, Tools Builder'ın bağlı bağlantı testini çalıştırın, üretilen dosyaları kontrol edin ve bağlayıcıyı hazır olarak tedavi etmeden önce paketi uygun hale getirin.
Oluşturulan sürüm onu yaratır API Ve kendi iş kayıtlarından gelen sözleşmeler. Sizin dağıtımınız kendi halklarına aittir URL, sırlar, depolama ve cron / işçiler, bu yüzden bir bulut ortamından varsayılması yerine yüklü sürüme karşı davranışı doğrulanmalıdır.
Bir bağlantı, adaptör içeren bir yönetilen pakettir, settings.json, Seçmeli actions.json, üretilen bir yetenek sözleşmesi, belge ve opsiyonel işletme uzantıları. altı aşamalı Builder onu birleştirir; kayıt keşfeder; uygunluk ve serbest bırakma kapıları bunu doğrular.