ایجاد پلت فرم خود AI-operable
OpsIQمعرفی بازی A Clean RESTAPI, HMAC-sated webhooks, یک رجیستری اکشن و SDK های آماده به کشتی تعریف آنچه که حوادث آتش از سیستم شما، چه اقداماتی AI مجاز به اجرا است و چه داده ها برای خواندن امن است.OpsIQامضاها، سوابق، ثبت های حسابرسی و جریان های تأیید را برای شما اداره می کند.
درخواست در ثبت نام وب سایت به بیرون
شما به سمتOpsIQ APIبا کلید Bearer دامنه شماOpsIQمحدوده و نقش را بررسی کنید، اقدام قراردادی را اجرا کنید، یک ردیف حسابرسی بنویسید - سپس یک وب سایت HMAC امضا شده را به نقطه پایانی خود شلیک کنید.هر پرش معتبر است، idempotent و دوباره در شکست مورد بازجویی قرار می گیرد.
از صفر تا یک ادغام زنده در چهار قدم
یک کلید را تنظیم کنید، اولین رویداد خود را آتش بزنید، یک وب را به اشتراک بگذارید، یک اقدام ثبت کنید.شما می توانید کل حلقه را در برابر جعبه شنی قبل از لمس داده های تولید اجرا کنید.
یک کلید را بردارید
ثبت نام کنید و یک Bearer دامنه ایجاد کنیدAPIکلید (opq_…• در تنظیمات توسعه دهنده، و هر ادغام را فقط سطوح مورد نیاز خود را ارائه دهید.
آتش و مشترک
امضای امضا شده events/fire (یا استفاده از یکSDKو سپس هر نقطه ای راURLدر هر صورت، با یک شناسه تحویل و retries back-off امضا شده است.
ثبت یک اقدام
یک قرارداد اقدام امضا شده را امضا کنید تا AI بتواند با خیال راحت عملیات را با بررسی های نقش، سیاست تأیید و یک مسیر حسابرسی کامل اجرا کند.
یک الگوی اتصال پنج اصل پاک
هر گونه زندگی خاص پلت فرم در یک کانکتور.OpsIQهسته عمومی باقی می ماند، AI قابل پیش بینی باقی می ماند و ادغام شما قابل حسابرسی است.
توضیح دهیدOpsIQچه اتفاقی افتاد.
حوادث جهانی آتش از پلت فرم شما - یا نام رویداد سفارشی خود را.هر مشترک در زمان واقعی واکنش نشان می دهد، به ترتیب اولویت.
مرجع Eventinvoice.paid, ticket.created, subscription.cancelled, customer.signed_up یا خود شما.
مشترکین Fan-outمغز AI، قوانین اتوماسیون، کانکتورهای آینه و نقاط پایانی وب شما همگی واکنش نشان می دهند.
اولویت بندیارسال قطعی آینه ها قبل از آتش هشدار
توضیح دهیدOpsIQآنچه که AI مجاز به انجام آن است.
یک قرارداد اقدام امضا شده است.JSONبیانیه: چه کاری انجام می دهد، چه نقش هایی می تواند آن را اجرا کند، چه پارامترهایی را بپذیرد، چه تاییدی لازم است و نقطه پایانی تماس.
طرح Action{
"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به هر رویداد.OpsIQدانلود زیرنویس فارسی The POSTsJSONمحموله امضا شده با HMAC-SHA در بدن خام - آن را در چند خط بررسی کنید.
$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);
مشتریان را برای زبانی که قبلا استفاده می کنید، رها کنید.
سه SDK رسمی با احراز هویت، امضای، retries، کلیدهای قابلیت شناسایی و پاسخ های تایپ شده کار می کنند.SDKیک بسته بندی نازک در اطراف همان سطح REST است.
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().
Manifest-basedactions.json و settings.json قراردادها و config را اعلام کنید.
کشف خودکارسپس آن را وارد کنید و آن را در داخل آن قرار دهید.
انگلیسی ساده عملیات حسابرسی شده
OpsIQهرگز تماس درست را اختراع نکنید، از طریق قراردادهای ثبت شده پیاده روی می کند، محموله را آماده می کند، درخواست تایید زمانی که عمل نیاز به آن دارد، و یک ردیف حسابرسی کامل در هنگام اجرای آن ایجاد می کند، بنابراین AI که می تواند آن را اجرا کند. عمل هرگز به هوش مصنوعی تبدیل نمی شود که نمی توانید به آن اعتماد کنید.
سطح API در یک نگاه
هر نقطه پایانی هسته ای، حقیقت، هویت و محدودیت نرخ هر کلید است. قرارداد کامل قابل خواندن ماشین در OpenAPI زندگی می کند.3.0.3مرجع
POST /v1/events/fireHMACبله1000/ minPOST /v1/actions/runHMACبله200/ minPOST /v1/webhooks/testHMACبله60/ minGET /v1/customers/{id}HMACبله2000/ minGET /v1/ticketsHMACبله2000/ minGET /v1/connectorsHMACبله2000/ minمحدودیت های نرخ در هر کلید و بازگشت به هر پاسخ به عنوان X-OpsIQ-RateLimit-Remainingبیش از حد بازگشت 429 با یک Retry-After هدر: قرارداد کامل قابل خواندن ماشین (هر نقطه پایانی، طرح و خطا) در زندگی می کند. OpenAPI3.0.3مرجع مرجع.
کشتی یک کانکتور در پنج قدم
یک کانکتور یک پوشه مستقل است.OpsIQاین را کشف می کند، رجیستری رویدادها را ارائه می دهد و کد خاص پلت فرم شما هرگز به هسته نفوذ نمی کند.
connector.php گسترش AbstractConnector.actions.json و settings.json آشکاریک کلید sandbox و یک تست کننده وب را بزنید.
هر فضای کاری یک Sandbox را افشا می کند: یک کلید جداگانه که به همان نقطه برخورد می کند.APIسطح بدون لمس کردن داده های تولید POST /v1/webhooks/test برای شلیک یک نمونه امضا شده در نقطه پایانی شما و تأیید تایید امضای خود قبل از رفتن به زندگی. نصبهای خود- میزبان مسیر کد مشابه را اجرا میکنند، بدون هیچ حرکت رفتاری بین ابر و بر روی محل.
OpsIQدر مقابل ادغام DIY
چه یک پلت فرم قرارداد، امضا شده، حسابرسی به شما می دهد که نورد وب سایت خود و لوله کشی AI-action هرگز نخواهد بود.
| قابلیت | خودتان را رول کنید | 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، امضاها، SDK ها، Sandbox و مدل اتصال: همه چیزهایی که قبل از درخواست اول از آن می پرسید.
Authorization: Bearer opq_…. OpsIQمحدوده کلید و نقش بازیگر را قبل از هر چیزی که اجرا می شود، بررسی کنید. Webhooks جداگانه است: هر وب سایتhooksOpsIQارسال یک X-OpsIQ-Signature (یک HMAC-256 از بدن خام) و یک X-OpsIQ-Timestamp برای محافظت مجدد، بنابراین شما می توانید ما را در عوض تأیید کنید و وب سایت های ورودی که ارسال می کنید به همان روش تایید شده اند.requires_confirmation یک کارت پیش نمایش را به یک انسان قبل از عوارض جانبی اجرا می کند.hash_hmac('sha256', $rawBody, $secret) (یک پیشوند Hx هضم بدون پیشوند) و مقایسه آن با پیشوند X-OpsIQ-Signature هدر با یک چک زمان ثابت (hash_equalsهر تحویل همچنین دارای یک timetamp، یک کلید idempotency و یک شناسه تحویل است که می توانید آن را ردیابی کنید.کل قطعه PHP در این صفحه است.POST /v1/webhooks/test برای شلیک یک نمونه امضا شده در نقطه پایانی شما و تأیید اعتبار قبل از رفتن به حالت زنده.AbstractConnectorبه علاوه، actions.json و settings.json آشکاری که شما پیاده سازی می کنید identityProviders(), contextProviders(), registerActions(), subscribers() و handleWebhook(). OpsIQکشف خودکار آن، رویدادها را سیم می کند و کد خاص پلت فرم خود را به صورت تمیز از هسته جدا می کند.