رفتن به متن

API و اتصال

داده‌های طرح، قابل خواندن برای سیستم‌های دیگرتان.

فروشگاهی که رنگ‌بندی‌ها را نشان می‌دهد، سیستم کارخانه‌ای که منتظر نقشهٔ تأییدشده است، یا پیکربندی روی سایت خودتان. همه از راه API عمومی به همان سرویسی وصل می‌شوند که طراح‌هایتان با آن کار می‌کنند.

# طرح‌های یک فضای کار

$ 
{
  "data": [{
    "id": "cmh2x...",
    "title": "Medallion, indigo",
    "drawnFor": { "technique": "HANDWOVEN", "raj": 40, "knotAspectRatio": 1.15 },
    "latestVersion": { "sequence": 4, "status": "IN_REVIEW" }
  }],
  "next": null
}

وب‌هوک رسید

POST https://your-shop.example/toranj
Toranj-Event: version.approved
Toranj-Signature: t=1793520000,v1=9f2c...

دیدن سند OpenAPI

REST API مستند

طرح‌ها، نسخه‌ها، بافت روی هر دار و داده‌های برنامهٔ شما، همه زیر ‎/v1. سند OpenAPI 3.1 از همان تعریف‌هایی ساخته می‌شود که سرویس درخواست‌ها را با آن می‌سنجد، پس این دو از هم جدا نمی‌افتند.

وب‌هوک، هنوز خاموش

رویدادها در همان تراکنشی ثبت می‌شوند که خود تغییر انجام شده، و امضا و تلاش دوبارهٔ وب‌هوک در نرم‌افزار آماده است. ولی فرستادنش در نسخهٔ فعلی سایت روشن نیست. اگر لازمش دارید به ما بگویید.

لینکی که ویرایشگر را باز می‌کند

سیستم شما می‌تواند لینکی یک‌باره بخواهد که ویرایشگر را برای یک نفر و روی یک طرح باز کند. آن شخص نه صفحهٔ ورودی می‌بیند و نه چیز دیگری.

کلید برای یک فضای کار

کلید هر برنامه فقط در یک فضای کار و با همان دسترسی‌هایی کار می‌کند که داده شده: خواندن، نوشتن، داده. کلید را فعلاً خودمان برایتان می‌سازیم و باطل که شود از کار می‌افتد. هر کار در تاریخچه نام انجام‌دهنده‌اش را دارد.

دستیار هوش مصنوعی، با همان قوانین

سرور MCP همان ابزارهای طراح را به دستیاری مثل Claude می‌دهد: کشیدن، گذاشتن نقش‌مایه، گرفتن خروجی، خواندن تغییرها. با نام خودش در تاریخچه ثبت می‌شود و هرگز نمی‌تواند نسخه‌ای را تأیید کند.

جزئیات

درخواست دسترسی
پروتکل
REST، JSON، OpenAPI 3.1
احراز هویت
کلید Bearer، با دسترسی محدود، برای یک فضای کار
رویداد
وب‌هوک امضاشده با تلاش دوباره؛ فرستادنش فعلاً خاموش است
پلن
کلید را فعلاً خودمان می‌سازیم؛ وب‌هوک در پلن استودیو است
هوش مصنوعی
سرور MCP
بعدیطراحیوکتور، قرینه و کتابخانهٔ نقش