qub للمطورين

qub للمطوّرين

واجهة HTTP API ذات إصدارات تحت /api/v1، ويذكر مستند OpenAPI الخاص بها حاليًا إصدار API 1.0.0. تُدعَم ثلاثة مسارات للتكامل:

• HTTP API — يُولَّد السطح الخارجي الكامل من العمليات الموسومة بـ x-audience: external في /api/v1/openapi.json. لا تحتاج العمليات العامة إلى بيانات اعتماد؛ وتستخدم عمليات الكتابة من المتصفح Cloudflare Turnstile؛ وتستخدم استدعاءات Builder Authorization: Bearer qub_sk_…. تقبل /api/v1/upload بايتات مختومة محليًا، بينما /api/v1/seal مسار نص واضح موثوق به صراحةً على جانب الخادم.
• خادم MCP — tools/qub-mcp ثنائي Rust محلي لعمليات الإنشاء والقراءة والحالة. يختم محليًا وينشر qubs خاصة مغلّفة. النشر معطّل افتراضيًا؛ ويتطلب create_qub كلًا من QUB_API_KEY و QUB_MCP_ALLOW_CREATE=true. تأخذ القراءة إما رابط التسليم الكامل الحامل للجزء، أو tx_id مع key_base64url.
• التضمين — يعرض <qub-embed src="https://qub.social/c/<tx_id>#<key>"> العدّ التنازلي الحي والكشف ضمن الصفحة. تستخدم qubs العامة صيغة src نفسها بلا جزء. استخدم المُحمِّل المثبّت /embed/v1.js؛ أما /embed.js فليس سوى الاسم المستعار المتحرك.

تتحقق حزم .qub المحمولة من نزاهة المحتوى، والربط بجولة drand، والتوقيعات دون اتصال. أما إثبات أن النص المشفر كان موجودًا بحلول وقت معيّن فيتطلب أيضًا معاملة تخزين دائم مُتحقَّقًا منها أو إثباتًا مُرسًى في سجل الشفافية.

انظر llms.txt للملخص الموجّه للوكلاء، وllms-full.txt لحزمة الوثائق المجمّعة، ومرجع OpenAPI المعروض للمخططات والاستجابات.