ทําแพลตฟอร์มของคุณ เหมาะสมที่สุด
OpsIQ เปิดโปง ความ ไม่ สะอาดAPIHMAC ลงนามในเว็บฮุค (HMAC) ผลงานประกอบ และ SDKs ที่พร้อมใช้งาน กําหนดเหตุการณ์ต่าง ๆ ที่เกิดขึ้นจากระบบของคุณ สิ่งที่ปฏิบัติการ AI ได้รับอนุญาตให้ทํางาน และข้อมูลใด ๆ ที่ปลอดภัยในการอ่านOpsIQ จัดการลายเซ็น, การรีเฟรช, การตรวจสอบปูมบันทึกและการยืนยันการไหลสําหรับคุณ
ขอเข้าไป ลงชื่อเว็บฮุค
คุณ POSTOpsIQ API ด้วยกุญแจสายรัดของคุณOpsIQCheck date และ page, ดําเนินการตามสัญญา, เขียนแถวการตรวจสอบ - จากนั้นยิง HMAC ที่เซ็นลงเว็บฮุคกลับไปที่จุดสิ้นสุดของคุณ ทุก ๆ ครั้งจะยืนยัน, idmotent และแก้ไขเมื่อล้มเหลว
จากศูนย์ถึงการรวมตัวแบบสดๆ สี่ขั้นตอน
สร้างคีย์, กดปุ่มแรกของคุณ, รับสมัครงานเว็บฮุค, จดบันทึกการกระทํา คุณสามารถเรียกวงเวียนทั้งหมดมาชนกล่องทรายก่อนจะทําการสร้างข้อมูล
เอากุญแจมา
ลงชื่อและสร้างเครื่องปรับเสียงAPI กุญแจ (opq_…ในระบบพัฒนา และให้แต่ละการผนวกเท่านั้น พื้นผิวที่จําเป็น
การสมัครสมาชิกของไฟ
ส่งการลงนาม events/fire (หรือใช้SDK งั้นชี้ทางURL ไม่ว่ากรณีใดก็ตาม, ลงนามด้วยบัตรประจําตัว และเครื่องสํารองหลังคลอด
ลงทะเบียนการกระทํา
ประกาศสัญญาปฏิบัติการเพื่อให้ AI สามารถดําเนินการอย่างปลอดภัยกับการตรวจสอบบทบาทนโยบายยืนยันและติดตามเต็มรูปแบบ
รูปแบบการเชื่อมต่อหนึ่ง ห้าพื้นฐานสะอาด
อะไรก็ตามที่ระบุในแพลตฟอร์ม ชีวิตที่เชื่อมต่อกันOpsIQแกนหลักยังคงทั่วไป, เอไอคงคาดเดาได้, และการรวมของคุณยังคงตรวจสอบได้
บอกOpsIQ สิ่งที่เพิ่งเกิดขึ้น
ยิงเหตุการณ์ทั่วไปจากแพลตฟอร์มของคุณ หรือชื่อเหตุการณ์ของคุณเอง เหตุการณ์ที่กําหนดเองทุกตัวตอบสนองในเรียลไทม์ตามลําดับ
อ้างอิงเหตุการณ์invoice.paid, ticket.created, subscription.cancelled, customer.signed_up หรือเป็นของคุณ
ผู้บอกรับจดหมายสมอง AI กฎอัตโนมัติ การเชื่อมต่อกระจก และจุดปลายเว็บของคุณทั้งหมดตอบสนอง
ลําดับความสําคัญสัญญานดีนิพนธ์ เพื่อให้กระจกเขียนก่อนที่จะยิง
บอกOpsIQ สิ่งที่ AI ได้รับอนุญาตให้ทํา
สัญญากระทําคือลงนามJSON ประกาศ: สิ่งที่การกระทําทํา ซึ่งบทบาทใดสามารถเรียกใช้มัน สิ่งที่ตัวแปรมันยอมรับ ไม่ว่าจะเป็นการยืนยันจําเป็น และจุดสิ้นสุดที่จะเรียก
การกระทํา{
"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
}
ผลักดันเหตุการณ์ต่าง ๆ ที่เกิดขึ้นในกองของคุณ ด้วยหลักฐานทางวิชาชีพ
การสมัครสมาชิกใด ๆURL กับเหตุการณ์อะไรก็ตามOpsIQPOST TheJSONเซ็นสัญญากับ HMAC-HA256 ผ่านร่างดิบ - ตรวจสอบในไม่กี่บรรทัด
$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);
ส่งโปรแกรมลูกข่ายสําหรับภาษาที่คุณใช้อยู่แล้ว
SDKs อย่างเป็นทางการ 3 แบบ จัดการการตรวจสอบสิทธิ์, เซ็น, แก้ไขเพิ่มเติม, กดปุ่มพิมพ์แบบไม่จํากัด และป้อนข้อมูลแบบพิมพ์ หรือรักษากรอบ - ทุก ๆ แบบSDK เป็นผ้าบางรอบพื้นผิวเดียวกัน
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",
})
สร้างหนึ่งครั้ง เสียบปลั๊กใส่อะไรก็ได้
การเชื่อมต่อคือโฟลเดอร์ที่มีคลาส PHP หนึ่งชั้นOpsIQค้นพบมัน การลงทะเบียนสายเหตุการณ์ และรหัสในแพลตฟอร์มของคุณ ยังคงแยกออกจากแกนอย่างสะอาด
ส่วนเสริมสําหรับเชื่อมต่อidentityProviders(), contextProviders(), registerActions(), subscribers(), handleWebhook().
ไดรฟ์แบบแสดงภาพactions.json และ settings.json ประกาศสัญญาและปรับแต่ง
ค้นพบอัตโนมัติทิ้งโฟลเดอร์ลง, เซ็น, เปิดให้ใช้admin ได้
ภาษาอังกฤษธรรมดา ดําเนินการเสร็จแล้ว
OpsIQ ไม่เคยประดิษฐ์การโทรที่ถูกต้อง มันเดินผ่านสัญญาลงทะเบียน เตรียมภาระ, เรียกยืนยันเมื่อกระทําความต้องการ และผลิตแถวการตรวจสอบที่สมบูรณ์เมื่อดําเนินการเพื่อให้ AI การกระทํา ไม่เคยกลายเป็นปัญญาประดิษฐ์ที่ไว้ใจไม่ได้
API ผิวเผิน เหลือบมอง
ทุกจุดปลายหลัก, auth, idmotable และอัตราต่อคีย์ จํากัด. สัญญาเต็มเครื่องอ่านได้ ชีวิตใน OpenAPI3.0.3 อ้างอิง
POST /v1/events/fireMACใช่1000/ นาทีPOST /v1/actions/runMACใช่200/ นาทีPOST /v1/webhooks/testMACใช่60/ นาทีGET /v1/customers/{id}MACใช่2000/ นาทีGET /v1/ticketsMACใช่2000/ นาทีGET /v1/connectorsMACใช่2000/ นาทีอัตราจํากัดเป็น 1 คีย์ และกลับมาทุกการตอบสนอง X-OpsIQ-RateLimit-RemainingHOURSฟังก์ชัน () จะคืนค่ากลับมาเป็นชั่วโมงของค่าเวลาที่กําหนด 429 ด้วย Retry-After หัวกระดาษ สัญญาเต็มเครื่องจักรอ่านได้ (ทุกจุด, ทุก Shema และความผิดพลาด) อาศัยอยู่ใน OpenAPI3.0.3 อ้างอิง.
ส่งการเชื่อมต่อใน ห้าขั้นตอน.
ตัวเชื่อมต่อคือโฟลเดอร์ที่รวมเข้ากับตัวมันเองOpsIQค้นพบมัน, การจัดระบบสายเหตุการณ์ และรหัสในแพลตฟอร์มของคุณ ไม่เคยรั่วไหลเข้าไปในแกน
connector.php ขยาย AbstractConnector.actions.json และ settings.json เปิดเผยกุญแจกล่องทราย และเครื่องทดลองเว็บฮุค
พื้นที่การทํางานทุก แฉกล่องทราย: กุญแจแยกที่อ่านได้ตรงเดียวกันAPI ผิวเผินโดยไม่ต้องจับข้อมูลการผลิต ใช้ POST /v1/webhooks/test เพื่อยิงตัวอย่างที่เซ็นส่งที่จุดสิ้นสุดของคุณ และยืนยันลายเซ็นของคุณก่อนการออกอากาศ เครื่องติดตั้งด้วยตนเองใช้เส้นทางรหัสเดียวกันนี้
OpsIQvs a การอินทิเกรต DIY
สิ่งที่สัญญากําหนดมา, ลงนาม, เวทีตรวจสอบ ช่วยให้คุณกลิ้งเว็บฮุคของคุณเอง และท่อ AI-active จะไม่มีทาง
| ความจุ | กลิ้งตัวเอง | 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) | ไดเรกทอรี | ✓ |
| Connector pattern: platform code stays isolated | — | ✓ |
คําถามนักพัฒนา ตอบมา
Auth, ลายเซ็น, SDKs, Sandboxing และตัวเชื่อมต่อ: ทุกอย่างที่คุณต้องการก่อนการร้องขอครั้งแรก
Authorization: Bearer opq_…. OpsIQ ตรวจสอบขอบเขตคีย์และบทบาทของนักแสดง ก่อนที่จะสิ่งที่เรียกใช้. เว็บฮุคจะแยก: ทุกเว็บฮุกOpsIQ ส่งพา X-OpsIQ-Signature (A HEX HMAC-HA256 ของร่างกายดิบ) และ X-OpsIQ-Timestamp เพื่อรับบทป้องกัน คุณจะสามารถยืนยันเราในผลตอบแทน และเว็บฮุคที่คุณส่งมา จะได้รับการยืนยันแบบเดียวกันrequires_confirmation นําเสนอใบแสดงตัวอย่างให้มนุษย์ ก่อนที่จะเกิดผลกระทบข้างเคียงhash_hmac('sha256', $rawBody, $secret) (เสียงเฮ็กซ์ย่อย with no laid) และเปรียบเทียบกับ X-OpsIQ-Signature ส่วนหัวที่มีการตรวจสอบคงที่ (Scure-time)hash_equals. การส่งมอบทุกอย่างยังพกพาเวลา กุญแจอิดิเมเตอร์ และหมายเลขประจําตัวการจัดส่งPOST /v1/webhooks/test เพื่อยิงตัวอย่างที่เซ็นไว้ ที่ปลายทาง และยืนยันผลการตรวจสอบของคุณ ก่อนที่จะออกอากาศAbstractConnector# บวก actions.json และ settings.json ผลงาน คุณสั่งงาน identityProviders(), contextProviders(), registerActions(), subscribers() และ handleWebhook(). OpsIQปิดกั้นมันอัตโนมัติ เชื่อมต่อเหตุการณ์ และเก็บรหัสในแพลตฟอร์มของคุณ ที่แยกออกจากแกนอย่างสะอาด