platformunuzu yapın Yapay zeka ile çalışabilir.
OpsIQ temiz bir REST API, HMAC-signed webhooks, bir eylem-uzay kaydı ve sistemden hangi olayları ateşlettiğini, AI'nın ne işe gitmesine izin verildiğini ve hangi verilerin okunması güvenli olduğunu kanıtlayın. OpsIQ iş imzaları, retries, denetim logları ve onay akışlarını sizin için.
İstek içinde. Çıkış webhook dışarı.
OpsIQ API with your scoped Bearer key. OpsIQ checks kapsamı ve rolü, sözleşmeli eylemi çalıştırın, bir denetim sırasını yazın - sonra uç noktanıza bir HMAC imzalı webhook ateş. her umut gerçekleştirilebilir, idem ve başarısızlık üzerine yeniden katkıda bulun.
Sıfırdan canlı bir entegrasyona Dört adım.
Bir anahtar, ilk olayınızı ateşleyin, bir webhook abone olun, bir eylem kayıt edin. Üretim verilere dokunmadan önce tüm döngüyü çalıştırabilirsiniz.
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.
Fire & abone
POST imzalanmış bir imza events/fire (veya bir SDK) sonra herhangi bir olayda URL'ı kullanın, teslimat kimliği ve geri dönüşleri ile imzalayın.
Bir eylem kayıt olun
İmzalanan bir eylem sözleşmesine karar verin, böylece AI güvenle operasyonları çalıştırabilir, rol kontrolleri, onay politikası ve tam denetim yolu ile.
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.
OpsIQ ne oldu.
Platformunuzdan evrensel olaylar - veya kendi özel etkinlik isimleri. Her abone gerçek zamanlı olarak tepki verir, öncelik sırası.
Event referansinvoice.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.
OpsIQ AI'nın ne yapmasına izin verildiğine söyle.
Bir eylem sözleşmesi imzalanmış bir JSON Açıklama: hangi rollerin çalıştırabileceği, hangi parametreleri kabul ettiği, onayın gerekli olup olmadığını ve çağrının son noktası.
Action şema{
"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
}
Taklitlerinize - kriptografik kanıt ile olayları.
Herhangi bir etkinliğe URL abone olun. OpsIQ POSTs the JSON maaş yükü HMAC-SHA256 ile birkaç satırda imzalanmıştır - bunu doğrulayın.
$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);
Zaten kullandığınız dil için sol müşteriler.
Üç resmi SDKs kimlik doğrulama, imza, yeniden imzalar, idempotency anahtarları ve tip yanıtlar. veya framework-free - her SDK aynı REST yüzeyinin etrafında ince bir sarmadır.
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",
})
Bir kez inşa edin. bir şeye tak.
Bir bağlantı bir PHP sınıfı ile bir klasördür. OpsIQ bunu keşfeder, kayıt telleri olayları ve platform özel kodunuz çekirdekten temiz kalır.
Links guideidentityProviders(), contextProviders(), registerActions(), subscribers(), handleWebhook().
Manifest-güdümlüactions.json ve settings.json Sözleşmeleri ve yapılandırıyı beyan eder.
Otomatik keşfedildiklasörü içeri girin, imzalayın, bunu admin'de etkinleştirin.
İ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.
API yüzey Bir bakışta.
Her temel uç noktası, auth, idempotency ve per-key oranı limiti. tam makine hazırlı sözleşme OpenAPI 3.0.3 referansında yaşıyor.
POST /v1/events/fireHMACEvet1000 / dkPOST /v1/actions/runHMACEvet200 / dkPOST /v1/webhooks/testHMACEvet60 / dkGET /v1/customers/{id}HMACEvet2000 / dkGET /v1/ticketsHMACEvet2000 / dkGET /v1/connectorsHMACEvet2000 / dkPuan sınırları anahtar başınadır ve her yanıta geri döndü X-OpsIQ-RateLimit-RemainingLimitin aşılması 429 Biriyle birlikte Retry-After Başlık: Tam makine hazırlanabilir sözleşme (her uç nokta, şema ve hata) hayatta OpenAPI 3.0.3 referans.
Gemide bir bağlantı Beş adım.
Bir bağlantı kendi kendine özgü bir klasördür. OpsIQ bunu keşfeder, kayıt telleri olayları ve platform özel kod asla anaya sızdırmıyor.
connector.php Genişleme AbstractConnector.actions.json ve settings.json Açıklar.Bir kumbox anahtarı ve bir webhook testier.
Her çalışma alanı bir kum kutusu ortaya çıkarır: aynı zamanda vuran ayrı bir anahtarAPIÜretim verilere dokunmadan yüzey. Kullanımı POST /v1/webhooks/test Son noktanızda imzalanmış bir örnek teslim ateş etmek ve daha önce imza doğrulamanızı onaylayın. Kendi ev sahibi taksiler aynı kodu yol çalıştırıyor, bulut ve on-prem arasında hiçbir davranışsız sürüklenme.
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.
| Yetenekli | Kendin kendi kendine yuvarlayın | 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) | Varies Var | ✓ |
| Connector pattern: platform code stays isolated | — | ✓ |
Geliştirici soruları, Cevap verdi.
Auth, imzalar, SDKs, sandboxing ve bağlantı modeli: ilk istekten önce soracağınız her şey.
Authorization: Bearer opq_…. OpsIQ, anahtarın kapsamını ve aktörün rolünü her şeyden önce kontrol eder: Webhooks ayrıdır: Her webhook OpsIQ gönderir X-OpsIQ-Signature (Kıbrıs vücuduna bir hex HMAC-SHA256) ve bir hex X-OpsIQ-Timestamp Yeniden oyun koruma için, bu yüzden geri dönüşte bizi doğrulayabilirsiniz ve gönderdiğiniz webhooks aynı şekilde doğrulanır.requires_confirmation Yüzeyler yan etkiler başlamadan önce bir insana bir önizleme kartı.hash_hmac('sha256', $rawBody, $secret) (Bir hex önceden ekle sindirme) ve onu karşılaştırmak X-OpsIQ-Signature Sürekli zamanlı bir kontrolle başlayın (hash_equalsHer teslimat aynı zamanda bir zaman çizelgesi taşır, bir idempotency anahtarı ve bir teslimat ID'si takip edebilirsiniz. Bu sayfada PHP parçaları tüm doğrulamadır.POST /v1/webhooks/test Son noktanızda imzalanmış bir örnek teslim ateş etmek ve yaşamadan önce doğrulamanızı onaylayın.AbstractConnectorartı actions.json ve settings.json Açıklar. Uygulamayı uygulayın. identityProviders(), contextProviders(), registerActions(), subscribers() ve handleWebhook(). OpsIQ auto-discovers it, events teller ve platforma özel kodunuzu temelden temiz bir şekilde ayırmaktadır.