Plancyal all arest เว็บฮุคส์ สืบค้นเมื่อ May SDKs

ทําแพลตฟอร์มของคุณ เหมาะสมที่สุด

OpsIQ เปิดโปง ความ ไม่ สะอาดAPIHMAC ลงนามในเว็บฮุค (HMAC) ผลงานประกอบ และ SDKs ที่พร้อมใช้งาน กําหนดเหตุการณ์ต่าง ๆ ที่เกิดขึ้นจากระบบของคุณ สิ่งที่ปฏิบัติการ AI ได้รับอนุญาตให้ทํางาน และข้อมูลใด ๆ ที่ปลอดภัยในการอ่านOpsIQ จัดการลายเซ็น, การรีเฟรช, การตรวจสอบปูมบันทึกและการยืนยันการไหลสําหรับคุณ

HMAC-HA256 ทั้งสองวิธีPHP Node สะกด SDKsOpenAPI3.0.3 สัญญา100% การตรวจสอบ
ร้องขอเข้าที่
ลงเว็บฮุกออก (hook)200 โอเค
สด ม้วนกระดาษ ○OpsIQ○ เซ็น ชื่อ ใน เว็บไซต์ POST /v1/actions/run เอ็กซ์OpsIQ- แยกแยะ { "action": "การโอน_in ident" "ยืนยัน": จริง? ISIFY สืบค้นเมื่อ 20 July 2015. ลายเซ็น ⁇ บทบาท + ขอบเขต ⁇ แถวที่ตรวจสอบเขียน @opsiq/sdkวิดเจ็ต บน "การกระทํา" ตรวจสอบ HMAC ⁇ จับ 200 โอเค
3SDKs อย่างเป็นทางการ: PHP, Node, Python
MACชะ-256ลงนามในทุกคําขอ
40+เหตุการณ์ที่ให้รับข้อมูลเหตุการณ์
100%รายงานข่าวการตรวจสอบบนการกระทํา
ไลฟ์ซีเคิลที่ร้องขอ

ขอเข้าไป ลงชื่อเว็บฮุค

คุณ POSTOpsIQ API ด้วยกุญแจสายรัดของคุณOpsIQCheck date และ page, ดําเนินการตามสัญญา, เขียนแถวการตรวจสอบ - จากนั้นยิง HMAC ที่เซ็นลงเว็บฮุคกลับไปที่จุดสิ้นสุดของคุณ ทุก ๆ ครั้งจะยืนยัน, idmotent และแก้ไขเมื่อล้มเหลว

HMAC- SSA256 เว็บฮุก - ค่าจ้างเว็บฮุคที่ส่งเข้ามา ลงนามเหนือร่างดิบAPI เรียกยืนยันด้วยกุญแจสายตรวจ
การหมุนใหม่อัตโนมัติ - ไม่มีสัญญาณส่งกลับ และพยายามอีกครั้ง ด้วยบัตรส่งของที่คุณตามรอยได้
กุญแจไม่เข้าใช้แบบออฟไลน์ การนํากลับมาใช้ใหม่ได้โดยการออกแบบ ดังนั้นการส่งมอบสินค้าซ้ํา จึงไม่เคยซ้ําสอง
แอพพลิเคชันของคุณ POST /v1/actions/run เอ็กซ์OpsIQ- แยกแยะ เอ็กซ์OpsIQ-เวลาประทับ เวียดกง - รุน - อากูเมต จุดปลายของคุณ POST /webhooks ตรวจสอบ HMAC 200 โอเค ตรวจสอบลายเซ็น ขอบเขต + บทบาทที่ตรวจสอบ ประมวลผลการกระทําแบบมีเครื่องหมาย แถวที่ตรวจสอบเขียน สกุลเวบวอค { "เคย""การกระทํา" "ส่ง_หมายเลข""dvv_8f2a9" "ความเหมาะสม"hyem_31c7 "พิธีกร"– "Sha256=9 c4 e0a7b..." } ส่ง
01 ร้องขอการเซ็น 02 ตรวจสอบ HMAC 03 ประมวลผลสัญญา 04 เขียนบทแถวตรวจสอบ 05 เซ็นสัญญาอนุญาตเว็บ
เริ่มทํางานเร็ว

จากศูนย์ถึงการรวมตัวแบบสดๆ สี่ขั้นตอน

สร้างคีย์, กดปุ่มแรกของคุณ, รับสมัครงานเว็บฮุค, จดบันทึกการกระทํา คุณสามารถเรียกวงเวียนทั้งหมดมาชนกล่องทรายก่อนจะทําการสร้างข้อมูล

คอนโซลกล่องทรายเชื่อมต่อแล้ว
DEVLOER CONESOLLHH Sandbox. 1 สร้างกุญแจขึ้นมา OCK_ มีชีวิตอยู่/ xMYS 2จุดไฟ POST/v1/events/fire"สั่ง" 3 บอกรับเว็บฮุค https://api.you.com/webhooks 4ลงทะเบียนการกระทํา SAAs. resented_inbox_incord escorted
การส่งSandbox ผลิต, รหัสเดียวกัน
01

เอากุญแจมา

ลงชื่อและสร้างเครื่องปรับเสียงAPI กุญแจ (opq_…ในระบบพัฒนา และให้แต่ละการผนวกเท่านั้น พื้นผิวที่จําเป็น

02

การสมัครสมาชิกของไฟ

ส่งการลงนาม events/fire (หรือใช้SDK งั้นชี้ทางURL ไม่ว่ากรณีใดก็ตาม, ลงนามด้วยบัตรประจําตัว และเครื่องสํารองหลังคลอด

03

ลงทะเบียนการกระทํา

ประกาศสัญญาปฏิบัติการเพื่อให้ AI สามารถดําเนินการอย่างปลอดภัยกับการตรวจสอบบทบาทนโยบายยืนยันและติดตามเต็มรูปแบบ

มันพอดีกันยังไง

รูปแบบการเชื่อมต่อหนึ่ง ห้าพื้นฐานสะอาด

อะไรก็ตามที่ระบุในแพลตฟอร์ม ชีวิตที่เชื่อมต่อกันOpsIQแกนหลักยังคงทั่วไป, เอไอคงคาดเดาได้, และการรวมของคุณยังคงตรวจสอบได้

01
ตัวกระตุ้น (Triggers)

บอกOpsIQ สิ่งที่เพิ่งเกิดขึ้น

ยิงเหตุการณ์ทั่วไปจากแพลตฟอร์มของคุณ หรือชื่อเหตุการณ์ของคุณเอง เหตุการณ์ที่กําหนดเองทุกตัวตอบสนองในเรียลไทม์ตามลําดับ

อ้างอิงเหตุการณ์
invoice.paid เหตุการณ์. ไฟร์ () สมอง AIบริบทที่มีชีวิตอยู่ กฎระดับความสําคัญ20 กระจกเขียนก่อน เว็บฮุคเซ็น
เหตุการณ์ที่กําหนดเองinvoice.paid, ticket.created, subscription.cancelled, customer.signed_up หรือเป็นของคุณ ผู้บอกรับจดหมายสมอง AI กฎอัตโนมัติ การเชื่อมต่อกระจก และจุดปลายเว็บของคุณทั้งหมดตอบสนอง ลําดับความสําคัญสัญญานดีนิพนธ์ เพื่อให้กระจกเขียนก่อนที่จะยิง
02 สัญญาการกระทํา /

บอกOpsIQ สิ่งที่ AI ได้รับอนุญาตให้ทํา

สัญญากระทําคือลงนามJSON ประกาศ: สิ่งที่การกระทําทํา ซึ่งบทบาทใดสามารถเรียกใช้มัน สิ่งที่ตัวแปรมันยอมรับ ไม่ว่าจะเป็นการยืนยันจําเป็น และจุดสิ้นสุดที่จะเรียก

การกระทํา
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
}
03/ เซ็นสัญญาอนุญาตเว็บ

ผลักดันเหตุการณ์ต่าง ๆ ที่เกิดขึ้นในกองของคุณ ด้วยหลักฐานทางวิชาชีพ

การสมัครสมาชิกใด ๆURL กับเหตุการณ์อะไรก็ตามOpsIQPOST TheJSONเซ็นสัญญากับ HMAC-HA256 ผ่านร่างดิบ - ตรวจสอบในไม่กี่บรรทัด

เล่นใหม่เพื่อป้องกันหมายเลขผู้ส่งที่จะติดตามได้สํารองหลังการรีเซ็ต
อ้างอิงเว็บฮุก
ตรวจสอบการจับเว็บ - php
$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);
04/ สดีเคs

ส่งโปรแกรมลูกข่ายสําหรับภาษาที่คุณใช้อยู่แล้ว

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",
})
PHP8.4+โหนด. js18+Python3.10+REST OpenAPI3.0.3
05/ รูปแบบการเชื่อมต่อ

สร้างหนึ่งครั้ง เสียบปลั๊กใส่อะไรก็ได้

การเชื่อมต่อคือโฟลเดอร์ที่มีคลาส PHP หนึ่งชั้นOpsIQค้นพบมัน การลงทะเบียนสายเหตุการณ์ และรหัสในแพลตฟอร์มของคุณ ยังคงแยกออกจากแกนอย่างสะอาด

ส่วนเสริมสําหรับเชื่อมต่อ
ตะขอห้าidentityProviders(), contextProviders(), registerActions(), subscribers(), handleWebhook(). ไดรฟ์แบบแสดงภาพactions.json และ settings.json ประกาศสัญญาและปรับแต่ง ค้นพบอัตโนมัติทิ้งโฟลเดอร์ลง, เซ็น, เปิดให้ใช้admin ได้
จาก เจตนา ที่ จะ ทํา ให้ ปลอด ภัย

ภาษาอังกฤษธรรมดา ดําเนินการเสร็จแล้ว

OpsIQ ไม่เคยประดิษฐ์การโทรที่ถูกต้อง มันเดินผ่านสัญญาลงทะเบียน เตรียมภาระ, เรียกยืนยันเมื่อกระทําความต้องการ และผลิตแถวการตรวจสอบที่สมบูรณ์เมื่อดําเนินการเพื่อให้ AI การกระทํา ไม่เคยกลายเป็นปัญญาประดิษฐ์ที่ไว้ใจไม่ได้

สัญญาสัญญา AI นําเสนอเฉพาะการกระทําที่คุณได้ลงทะเบียน
ยืนยันก่อนผลข้างเคียง การกระทําเสี่ยงจะปรากฏใบแสดงตัวอย่างก่อน
จําทั้งหมดได้ ทุกคํากระตุ้น การตอบสนองและการกระทํา ส่งผลให้มีผู้ติดตามในประวัติศาสตร์ AI
4 ขั้น▪ ตั้งใจ ตรวจ สอบ
MACเซ็นก่อนทําการประมวลผล
"คืนทุนให้อดัมในใบแจ้งหนี้ครั้งสุดท้าย" ขั้นตอน1มติอย่างตั้งใจ ○ เข้า กัน: saas. refined_inbox ผิวเผิน: Addmin play: เจ้าของขั้นที่2การตรวจสอบสิทธิ์ ขั้นตอน3_ยืนยันการเซ็น แสดงแถบข้อความ8421 ยืนยัน ขั้นตอน4 แถวของ eAudit นักแสดงบอกผลที่ออกมา412ms เจ้าของอย่างเดียวคือ ส่งออกเป็น CSVBAR_
ไม่มีสายที่ประดิษฐ์ขึ้นมาสัญญาอนุญาตเท่านั้น
ยืนยันการเปิดแสดงตัวอย่างก่อนลูกเล่นด้านภาพ
100%ถูกสอบสวนแล้วเริ่มทํางาน + ตอบสนอง
อ้างอิง

API ผิวเผิน เหลือบมอง

ทุกจุดปลายหลัก, auth, idmotable และอัตราต่อคีย์ จํากัด. สัญญาเต็มเครื่องอ่านได้ ชีวิตใน OpenAPI3.0.3 อ้างอิง

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ค้นพบมัน, การจัดระบบสายเหตุการณ์ และรหัสในแพลตฟอร์มของคุณ ไม่เคยรั่วไหลเข้าไปในแกน

1ทําสําเนาโฟลเดอร์ด้วย connector.php ขยาย AbstractConnector.
2ประกาศ actions.json และ settings.json เปิดเผย
3อัตลักษณ์ที่สมบูรณ์ บริบท และผู้ให้บริการเว็บฮุค
4บอกรับเหตุการณ์ที่คุณสนใจ
5เซ็นซะ วางไว้ แล้วเอาไปพิมพ์
ทดสอบก่อนที่จะส่ง

กุญแจกล่องทราย และเครื่องทดลองเว็บฮุค

พื้นที่การทํางานทุก แฉกล่องทราย: กุญแจแยกที่อ่านได้ตรงเดียวกันAPI ผิวเผินโดยไม่ต้องจับข้อมูลการผลิต ใช้ POST /v1/webhooks/test เพื่อยิงตัวอย่างที่เซ็นส่งที่จุดสิ้นสุดของคุณ และยืนยันลายเซ็นของคุณก่อนการออกอากาศ เครื่องติดตั้งด้วยตนเองใช้เส้นทางรหัสเดียวกันนี้

กุญแจกล่องทราย ตัวทดสอบเว็บฮุค งาน Cron-ไดรฟ์ กลุ่มเมฆที่ประกอบไปด้วยส่วนที่อยู่เอง
การเชื่อมต่อ. php. php
คลาส นักแสดงผู้ไม่เกี่ยวข้อง ขยาย AbstractConnector { การใช้งานสาธารณะ ฟังก์ชัน CRL (): ข้อความ { กลับ 'came'; } // เรสโซลที่เป็นนักแสดง การใช้งานสาธารณะ previewer () จะคืนค่ากลับมาเป็นค่าเป็นค่าจํานวนวินาทีของเวลาที่กําหนด พอร์ต { กลับ [สร้างใหม่ AcmeIdentityProvider()]; } / / / ป้อนข้อมูลสดๆ เข้าค่า AI การใช้งานสาธารณะ ฟังก์ชัน SECONDS () จะคืนค่ากลับมาเป็นค่าเป็นค่าจํานวนวินาทีของเวลาที่กําหนด พอร์ต { กลับ [สร้างใหม่ AcmeContextProvider()]; } // ตอบโต้OpsIQ เหตุการณ์ การใช้งานสาธารณะ ฟังก์ชัน SECONDS () จะคืนค่ากลับมาเป็นค่าเป็นค่าจํานวนวินาทีของเวลาที่กําหนด พอร์ต { กลับ ['ในใบแจ้งหนี้' => [สร้างใหม่ BillingMirror()]]; } / รับเว็บฮุกจาก acme การใช้งานสาธารณะ จับภาพ webg (*. )พอร์ต $body): ว่าง { /* … */ } }
○ วิธี ที่ มัน เทียบ กัน

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
ขนาด FAQ

คําถามนักพัฒนา ตอบมา

Auth, ลายเซ็น, SDKs, Sandboxing และตัวเชื่อมต่อ: ทุกอย่างที่คุณต้องการก่อนการร้องขอครั้งแรก

API เรียกยืนยันโดยใช้กุญแจตัวนับแบบเดียว Authorization: Bearer opq_…. OpsIQ ตรวจสอบขอบเขตคีย์และบทบาทของนักแสดง ก่อนที่จะสิ่งที่เรียกใช้. เว็บฮุคจะแยก: ทุกเว็บฮุกOpsIQ ส่งพา X-OpsIQ-Signature (A HEX HMAC-HA256 ของร่างกายดิบ) และ X-OpsIQ-Timestamp เพื่อรับบทป้องกัน คุณจะสามารถยืนยันเราในผลตอบแทน และเว็บฮุคที่คุณส่งมา จะได้รับการยืนยันแบบเดียวกัน
ไม่. API สามารถนําเสนอเฉพาะการกระทําที่มีอยู่ในรายการการกระทําของคุณ ซึ่งไม่สามารถคิดค้นการโทรได้ สัญญาแต่ละรายการจะประกาศพื้นผิว, บทบาท และตัวแปรต่าง ๆ และการกระทําใด ๆ ที่ถูกทําเครื่องหมายไว้ requires_confirmation นําเสนอใบแสดงตัวอย่างให้มนุษย์ ก่อนที่จะเกิดผลกระทบข้างเคียง
แก้ไขใหม่ hash_hmac('sha256', $rawBody, $secret) (เสียงเฮ็กซ์ย่อย with no laid) และเปรียบเทียบกับ X-OpsIQ-Signature ส่วนหัวที่มีการตรวจสอบคงที่ (Scure-time)hash_equals. การส่งมอบทุกอย่างยังพกพาเวลา กุญแจอิดิเมเตอร์ และหมายเลขประจําตัวการจัดส่ง
ของที่ไม่ยอมคืน200แต่ละคนถือกุญแจอิเล็กทรอนิกส์เดียวกัน การส่งซ้ําไม่เคยซ้ําสอง
SDK อย่างเป็นทางการสําหรับ PHP8.4 บวก, โหนด. js18+ และ Python3.10+ จัดการการเซ็น, การแจ้งข้อมูล, การกดปุ่มพิมพ์ และการพิมพ์ การตอบสนองแบบไม่แน่นอน3.0.3 สัญญาหรือโทรAPIตรงๆเลย
ใช่ ทุกพื้นที่เปิดเผยกล่องทรายAPIพื้นผิวโดยไม่สัมผัสข้อมูลการผลิต, บวก POST /v1/webhooks/test เพื่อยิงตัวอย่างที่เซ็นไว้ ที่ปลายทาง และยืนยันผลการตรวจสอบของคุณ ก่อนที่จะออกอากาศ
ใช่ ติดตั้งแบบส่วนตัว จะใช้เส้นทางรหัสเดียวกัน (การลงนามเดียวกัน, สัญญา OpenAPI เดียวกัน)
การเชื่อมต่อคือโฟลเดอร์ที่รวมเข้ากับโปรแกรมเอง โดยมีคลาส PP หนึ่งประเภทขยาย AbstractConnector# บวก actions.json และ settings.json ผลงาน คุณสั่งงาน identityProviders(), contextProviders(), registerActions(), subscribers() และ handleWebhook(). OpsIQปิดกั้นมันอัตโนมัติ เชื่อมต่อเหตุการณ์ และเก็บรหัสในแพลตฟอร์มของคุณ ที่แยกออกจากแกนอย่างสะอาด