اپنا پلیٹ فارم بنائیں اے-ای-ابل.
Call 2,418 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.
اس سے درخواست کی گئی. ایک بہت بڑی مصیبت تھی ۔
ایک عمل /api/v1.php جس میں وسیع پیمانے پر کل. OpsIQ کام کی جگہ پر نرمی کرتی ہے، عمل کے معاہدے اور اجازے کو دوبارہ ترتیب دیتی ہے، پھر اسے ختم کرتی ہے یا خشک کرتی ہے. ذیل میں شامل ہونے والے واقعات قابل ذکر کاوشوں کے ساتھ HMAC-signed delation queue چھوڑ دیتے ہیں
کلیدی حیثیت سے لیکر اتحاد قائم کرنا تین قدم.
کم از کم پریویل کلید کا حل، پیدا کردہ معاہدے کو جاننے، خشک رن لکھنے، پھر ایک ویب چوک کو دوبارہ شروع کریں جب آپ کو اطلاق کے پس منظر کی ادائیگی کی ضرورت ہو۔
کلید حاصل کریں
علامات بلند کرنے اور ایک وسیع گہرے فاصلے کو پیدا کرنے کی صلاحیت پیدا کرتے ہیں۔ API ( کلید )opq_…) ترقیاتی ترتیبات میں اور ہر ایک انفنٹری کو صرف سطح دے دیتا ہے
تلاش & بھول بھلياں
پڑھئے meta.actions, meta.action اور meta.scopesاستعمال dry_run لیکن یہ بات سچ ہے کہ اِس سے پہلے کہ ہم کسی کو قتل کر دیں ۔
Execut & Project
تحریر کے لئے ایک demptance entry شامل کریں، پھر آپ کا اختتام انتہائی ضروری واقعات پر مرکوز ہو جاتا ہے.
ایک متصل نقش. پانچ صاف ستھرا.
کسی بھی پلیٹ فارم میں رہتے ہیں OpsIQ بنیادی جینریک، اے آئی کے باقی رہنے والے ہیں اور آپ کے شمولیت کے قابل ہے.
تفصیلات OpsIQ ابھی کیا ہوا.
عام طور پر ، عام طور سے ، بعض لوگ اس تقریب کو رجسٹرڈ ترجیح اور ادائیگی کے اصولوں کے ذریعے حاصل کرتے ہیں ۔
واقعہ حوالہinvoice.paid, ticket.created, subscription.cancelled, customer.signed_up یا آپ کا یا آپ کا۔
فن پارے -اے آئی دماغ، خودکار دستور، آئی ایم ایل کوائلرز اور آپ کی ویبہوک سب کا رد عمل ہے ۔
معجزے کا حکمآتشبازی سے پہلے ہی یہ شیشے لکھ لیتے ہیں ۔
تفصیلات OpsIQ اے آئی کیا کرنے کی اجازت ہے.
ہر نام سے ایک قابل عمل معاہدہ ملتا ہے: وسیع، خصوصیت، پڑھنا یا لکھنا، خطرہ، تصدیق پالیسی، درخواست اور جوابات، خشک-ر مدد، عدم استحکام اور مستحکم غلطیوں کو لکھ کر لکھنا۔
عمل اسکیم{
"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"] }
}
آپ کے اسٹاک - گانے پر ایک ایسی بات واقع ہوئی ہے جس کا ثبوت ہے ۔
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.
$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
براہ راست ایچ ٹی پی استعمال کریں یا وہ کلائنٹ جو آپ کو ترجیح دیں
مکمل عمومیAPI اوپنپی آئی کے طور پر شائع ہوتا ہے۔ 3.0.3 اور پوسٹ مین۔ پی ایچ پی کے حوالہ جات جمع نوے اور پائیتھس انفنٹری کلائنٹ پر دستخط شدہ تقریب اور ویبوک بہاؤ؛ کسی بھی اسٹاک کو یکساں کہہ سکتے ہیں۔ JSON عملہ سطح براہ راست۔
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.",
},
)
ایک بار تعمیر کریں. کچھ میں پل.
ایک متصلہ پیکج ہے جو Incenter، Auth، ٹیسٹ، عمل، ٹریگرز اور جائزہ کے ذریعے بنایا گیا ہے یا درآمد کیا گیا ہے. اس کی ظاہری سطحیں بتاتے ہیں۔ OpsIQ ظاہر کرنے کی اجازت ہے.
چھ حروف کو وضح کر نے کے ليےانگریزی میں Plain English. آپریشن باہر.
OpsIQ کبھی صحیح کال ایجاد نہیں کرتا. یہ رجسٹرڈ عہدوں کے ذریعے چلتا ہے، ادائیگی تیار کرتا ہے، جب عمل درکار ہوتا ہے، تصدیق کی درخواست کرتا ہے، اور مکمل Audit قطر پیدا کرتا ہے، تو AI جو کہ کر سکتا ہے، عمل کبھی آپ پر اعتماد نہیں کر سکتے ایک AA نہیں بن سکتا.
API سطح اور آنکھیں جھکی ہوئی
One JSON POST surface exposes 2,418 named actions. Each generated contract declares auth scopes, read/write kind, risk, confirmation, request schema, dry-run, idempotency and stable errors.
ACTION tickets.replytickets.writedry_run + عدم استحکاموقت کو ڈھانپنا / رکھناACTION security.reportsecurity.writedry_run + عدم استحکاموقت کو ڈھانپنا / رکھناACTION platform.routes.writeاdmin+ کلید تصدیق کریںوقت کو ڈھانپنا / رکھناACTION meta.actionsخفیہ انکشافصرف پڑھیےوقت کو ڈھانپنا / رکھناACTION tickets.listtickets.readصرف پڑھیےوقت کو ڈھانپنا / رکھناACTION connectors.listconnectors.readصرف پڑھیےوقت کو ڈھانپنا / رکھناhr.* عہد وپیمان hr.read / hr.write نطاقACTION hr.people.listhr.readصرف پڑھیےوقت کو ڈھانپنا / رکھناACTION hr.people.createhr.writedry_run + عدم استحکاموقت کو ڈھانپنا / رکھناACTION hr.org.treehr.readصرف پڑھیےوقت کو ڈھانپنا / رکھناhr انکار، خالی فہرست نہیں ملتی. لوگ کیا ہیں؟.ٹریفک کی حدود ایک گھنٹے کے اندر کھڑکی پر فیٹیالئیر ہیں ۔ X-RateLimit-Limit, X-RateLimit-Remaining اور X-RateLimit-Reset؛ ایک مُضر درخواست دوبارہ واپس آتی ہے 429 ساتھ Retry-After. . استعمال کرو کھولیں 3.0.3 عہد یا پوسٹ مین جمع اسی رنر ٹائم رجسٹر سے پیدا ہوا۔
اِس سلسلے میں اِن سوالوں کے جواب حاصل کرنے کے لئے کتاب کو پڑھیں ۔ چھ مراحل ۔
پرو فا ئل سے شروع کريں یا خود اپنا عہد متعین کريں ۔ ہر مرحلے کو بنانے سے پہلے اسے خود ساختہ ملانے والا پیکج بنا لیتا ہے۔
محفوظ ، پھر رہائی کے دروازے کو پار کریں ۔
استعمال dry_run حمایت کار اقدام پر، معمار کے وابستہ اتصال کا امتحان چلایئے اور آزاد ہونے سے پہلے پیدا کردہ ظاہری اور عہدے کا جائزہ لیں۔ پیکج تصدیق نام ، ترتیبات اور درکار فائل؛ پس منظر کار کاروں نے جوابی کارروائی اور برآمدات کو حل کیا۔
پیکج کا دعویٰ نہیں کر سکتا اس کا کوڈ نہیں ہے۔
OpsIQ\Connectors\ConnectorContract اختیار۔ Runtime انکشاف، معمار، پہلا حصہ پیکج، مطابقت، جنرل۔ API اور ہر حوالہ جات یہ پڑھتے ہیں کہ ایک رجسٹر. کسی کو رجسٹر اور تین فائلیں پہلے ایک دوسرے سے متفق ہونا ضروری ہے۔ OpsIQ آپ کے لئے ایک قطار کو چلا.
- 01 connector.php فرسٹ کلاس
- 02 IdentityProvider.php بیرونی کلید قائم کریں
- 03 SalesIngest.php مصالحت (sules)
- 04 actions.json عمل
- 05 settings.json خود کار طور پر
- 06 connector_contract.json مشین اچھی طرح پڑھ سکتے ہیں
hmac-sha256 پری فے ایس آئی کی ادائیگی کی زیادہ سے زیادہ ادائیگی256 جواب اس ترمیم کو دستخط کے بعد سے تبدیل کیا گیا ہے۔ایک ed25519 دستخط کے جواب اس پر دستخط شدہ تھے۔ Nabtech. ، کو ئي ہوئی عوامی کلید سے چیک کریں اور کوئی شیئر راز نہیں ہے. ایک گزشتہ کوٹی اور پہلی کو جُز کو روکیں.
marketplace.json دستخط سے باہر ہے معینہ طور پر: نصب کنندہ اسے دستخط کے بعد لکھتا ہے، اس لیے پبلشر کبھی بھی اس پر دستخط نہیں کر سکتا تھا۔
ایک محافظ جو کبھی ناکام نہیں ہوا ہے۔ یہ بات بالکل سچ ہے ۔
سبز ٹیسٹ آج آپ کو کچھ نہیں توڑتے وہ آپ کو نہیں بتاتے کہ آپ نے لکھے ہوئے جو چیز آپ نے لکھی تھی وہ روکنے کے لیے بند کر دیں گے کیونکہ ایک محافظ جو کبھی بھی ایسا نہیں کر رہا ہے بالکل ایسے چوکور کی طرح گزرتا ہے جس کا کوئی کام نہ ہو، اس کا دل ہم مقصد پر روک دیتے ہیں اور مطالبہ کرتے ہیں کہ مینار چیخیں۔
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 }
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.
کبھی بھی میونسپل کا اطلاق نہیں ہوتا تھا ۔
تلاش عبارت نے اتفاق نہیں کیا، فائل غیر محدود، صوتی عبور کیا اور ثبوت ریکارڈ کیا گیا ہے۔ پرانے کوڈ کے تحت سبز کوڈ کے بارے میں جو کبھی پرانا نہیں تھا.
مسقط نے کچھ اور توڑ دیا.
سوتے لال ہو گئے کیونکہ فائل کو کُلوقتی یا بوٹسپر کی موت واقع ہوئی تھی اور اس نے ایک سرخ ریکارڈ قائم کر دیا تھا جس کا گارڈ سے کوئی تعلق نہیں تھا ۔ نام ناکامیوں میں جانچ.
یہ ڈسک پر ایک دھماکا نہیں چھوڑ سکتا۔
ہر مجوزہ اصل کو ویب پرر کے باہر ایک طرفدار درخت میں نقل کرتا ہے، نمایاں تبدیلی کو شناخت کرنے والا ایک نشان لکھتا ہے اور ہر خارجی راستے پر بند ایک بند بند کر دیتا ہے. ایک تباہ کن دوڑ سے ایک نشان اس فائل کے اگلے حصے کو اعزاز سے پہلے حاصل کیا جاتا ہے۔
کریپٹ ایک حکم ہے۔ باہر کوڈ کے ساتھ.
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/ settlement، عمل، معمار ایمپائر، سفر اور تجارتی مہم کی نقشہ سازی، کامرس کی نقل و حمل، متصل عہدوں اور رہائی کے مظاہر۔
- manifests ایک دوسرے سے متفق اور متفق ہیں۔
- صلاحیتوں رن ٹائم کلاس پر موجود ہے۔
- interfaces عملے کا عمل
- files ہر مطلوبہ فائل موجود ہے
- عمل عمل کا تعارف
- destructive تصدیق کی تصدیق کریں
- شناخت ایک مستحکم بیرونی کلید، ای میل نہیں
- دوبارہ پلے دوبارہ تجدید کاروں، کبھی نہیں
- عرفیت جمعيابي کا اضافہ کريں
- دستاویزات ریڈم، ڈیکلور، چیہلیوگ
- سا ئيس سب JSON جمع
$ 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
حقیقی غیر مصدقہ اکاؤنٹ پر پہلا خط لکھیں --live-settings=/secure/test-acme.json... جب بھی آپ اسے ابھی تک الٹ رہے ہیں، آخری ایک کے لئے کھول دیں --unsigned-ok: یہ درست ہے ۔
جو آپ فروخت کر سکتے ہیں کو فروخت کر رہے ہیں فائل ہے، رجسٹریشن نہیں ہے.
ایک متصل جو کہ اعلان فروخت کر سکتا ہے کہ کس کا اپنی ہی ذات عمل OpsIQ'کچھی تجارتی کرداروں. فائل کی موجودگی دعوٰی ہے. یہ فروخت شدہ ترتیبات میں ظاہر ہوتا ہے کہ وہ اس لمحے پکارتا ہے اور ختم ہو جاتا ہے جب وہ رک جاتا ہے. اس میں شامل ہونے اور سوال کرنے کے لئے کوئی فہرست نہیں ہے۔
ایک قُربیہ لکھیں ایک جنینی ریکارڈ کے لئے کردار کو ملا کر درج کرو. میچ کا مقصد : ایک ذخیرہ نو مگر ایک مُضر فعل کے علاوہ، آپ کے اِجتماع کے بعد جو بھی کاروباری قطرے کو براہ راست خط لکھ کر پلیٹ فارم کی پری ہوئی پرییلنگ، رسائی اور تصدیقی ڈاک کو ختم کرنا اور اِس کی تصدیق کرنا، تاجر کا اپنا نظام صرف نصف ایمان لانا recovery یا تو، ایک وقت کی آؤٹ بے قابو ہو جائے گا.
{
"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" }
}
}
}
connector_contract.json پیدا کیا جاتا ہے اور اس کی اسکیچ سیٹ کی جاتی ہے۔ additionalProperties:false، تو ایک ہاتھ سے چلنے والی بلاک میں کوئی کام نہیں ہوگا اور پھر اگلے ایجنٹ کے چلنے پر لکھ دیا جائے گا.
ایک کردار نہیں CommerceRole کوئی وجود نہیں ۔ OpsIQ کبھی بھی کسی آپریشنل نام سے کوئی نام نہیں لیتا، کیونکہ ایک نام وعدہ نہیں ہوتا۔
آپ میں عمل ضرور دکھائیے actions.json. . جو کوئی وجود میں نہیں آتا وہ مشتری سے وعدہ کرتا ہے جو اس وقت کچھ پیدا نہیں کرتا ۔
سب سے خطرناک وقت وہ ہے جس کے بعد پلیٹ فارم پہلے ہی سے کام کر چکا ہو سکتا ہے. کسی edm Afres "میری تحریر" کے بغیر، اپ اپ، واحد اختیارات ری ایکٹر اندھے ہیں یا آرڈر کھو رہے ہیں۔
کوئی بھی ادائیگی کی کلاس کے کردار کا بھی اعلان کرتا ہے۔ payment_profile ساتھ ماحول, webhook_verify فراہم کنندہ کی اپنی ترکیب استعمال کرتے ہوئے اور event_map. ایک غیر آئینی ماحول یہ ہے کہ کس طرح ٹیسٹ ماڈل فراہم کرنے والا زندہ ادائیگی لیتا ہے۔
OpsIQ وُجْلُمُ غلط.
کیا ایک معاہدہ ہو گیا، دستخط کیے گئے پلیٹ فارم آپ کو دے دیتا ہے کہ آپ کی ویبہہہُک اور اے آئیاے کے ذریعے کبھی نہیں گا ۔
| صلاحیت | اپنا بلے لگائیں | OpsIQ |
|---|---|---|
| کُلوقتی خدمت API + HMAC-signed webhooks | ہاتھ سے کام | ✓ |
| Dry-run لکھتے ہیں + 24- گھنٹے کامیاب اداکاری | ڈیي | ✓ |
| 1 بجے→5m→30m –→ 2h → 12hرنگ | خشک | ✓ |
| ایکشن-سپ رجسٹر (AI's list) | — | ✓ |
| پہلوی دور سے پہلے کی پالیسی کی تصدیق | — | ✓ |
| خامی کی تکمیل میں + درخواست برائے آئی ڈی | دستی ربط | ✓ |
| براہ راست ایچ ٹی پی + کلائنٹ کے اختیارات پیدا کرتے ہیں۔ | اپنا خط لکھیں | ✓ |
| کھولیں 3.0.3 مشین قابلِ تلاوت عہد | شاید | ✓ |
| چھ منزلہ تعمیر کنندہ + پیکج برآمد کرنے والا دروازہ | آلات سازی | ✓ |
| عملی طور پر قابل قبول کلیدیں اور گھنٹے کی حدود | وَس | ✓ |
| کوانٹر کی شکل : پلیٹ فارم کو الگ رہتا ہے۔ | — | ✓ |
ترقی پسند سوالات، جواب ملا ۔
توثیق، معاہدہ، بازنطینی، کلائنٹ نسل، محفوظ ٹیسٹ اور کنڈر ماڈل، پہلی پروڈکشن طلب سے قبل۔
Authorization: Bearer opq_…. کینز بے قابو، محدود یا پڑھ سکتے ہیں، کم از کم پریوار کی فضاء پر مشتمل ہو سکتا ہے، ایک گھنٹے کی حد تک اطاعت کرو اور کام کی جگہ پر اسے واپس کیا جا سکتا ہے. ویبوک سائننگ الگ ہے: X-OpsIQ-Signature, X-OpsIQ-Timestamp, X-OpsIQ-Event اور X-OpsIQ-Delivery.hash_hmac('sha256', $rawBody, $secret) اور اس کے kxdecimal dies کا موازنہ X-OpsIQ-Signature استعمال hash_equals. Validate X-OpsIQ-Timestamp اپنی ری ان ونڈو ونڈو میں اور استعمال X-OpsIQ-Delivery بطور۔ قابلِ دینا (table) شناخت کنندہ۔dry_run جس کے متعلق معاہدہ کو بنیاد بنایا گیا ہے، وہ کنیکٹر کی وابستگی اتصال امتحان چلانے، اس کی پیداواری فائلیں جانچنے اور اسے تیار کرنے سے پہلے پیکج مطابقت پیدا کرنے اور دروازے آزاد کرنے سے قبلsettings.json, optional actions.json. ، ایک مصنوعی معاہدہ، دستاویزات اور حسابی توسیع۔ چھاپنے والے معمار اسے جمع کرتا ہے؛ رجسٹرڈ اسے دریافت کرتا ہے ؛