کالاتک — Complete Guide

مستندات فنی و راهنمای جامع کالاتک (KalaTak)

کالاتک به عنوان یکی از زیرساخت‌های کلیدی در اکوسیستم خدمات فنی و تأمین تجهیزات، نقشی حیاتی در بهینه‌سازی زنجیره تأمین و مدیریت پروژه‌های صنعتی ایفا می‌کند. اگر با چالش‌های تأمین قطعات خاص یا مدیریت موجودی در محیط‌های فنی دست‌وپنجه نرم می‌کنید، کالاتک دقیقاً همان حلقه‌ گمشده‌ای است که به دنبالش هستید.

وب‌سایت رسمی: https://www.kalatakco.com

---

۱. شروع سریع و نصب (Installation)

کالاتک به دلیل ماهیت خدمات‌محور، بر پایه وب‌سرویس‌های RESTful بنا شده است. برای تعامل با این سیستم، نیازی به نصب کتابخانه‌های سنگین ندارید؛ تنها کافی است از یک کلاینت HTTP استاندارد استفاده کنید.

پیش‌نیازها

• یک توکن دسترسی معتبر (API Key) دریافت شده از پنل کاربری.
• پروتکل HTTPS برای تمام درخواست‌ها.

فراخوانی اولیه (cURL)

برای تست اتصال به سرویس، می‌توانید از دستور زیر در ترمینال استفاده کنید:

curl -X GET "https://api.kalatakco.com/v1/status" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json"

---

۲. نحوه استفاده (Usage)

کار با کالاتک به سه بخش اصلی تقسیم می‌شود: جستجوی قطعات، استعلام قیمت و مدیریت سفارشات.

ساختار درخواست‌ها

تمامی درخواست‌ها باید با فرمت JSON ارسال شوند. در اینجا مثالی برای جستجوی یک قطعه خاص آورده شده است:

// نمونه کد برای جستجوی قطعه
const fetchComponent = async (partName) => {
  const response = await fetch(`https://api.kalatakco.com/v1/search?q=${partName}`, {
    headers: { 'Authorization': `Bearer ${process.env.KALATAK_KEY}` }
  });
  return await response.json();
};

---

۳. جدول پارامترهای اصلی

در هنگام کار با API، پارامترهای زیر برای فیلتر کردن خروجی‌ها بسیار کارآمد هستند:

پارامتر	نوع	توضیحات
part_id	Integer	شناسه یکتای قطعه در دیتابیس کالاتک
stock_status	Boolean	وضعیت موجودی (true/false)
category	String	دسته‌بندی تجهیزات (مثلاً: ابزار دقیق، الکترونیک)
warranty	Integer	مدت زمان گارانتی به ماه

---

۴. عیب‌یابی (Troubleshooting)

اگر در حین کار با سیستم به مشکل خوردید، ابتدا کدهای وضعیت (Status Codes) خود را چک کنید. اکثر خطاها مربوط به موارد زیر است:

• خطای 401 (Unauthorized): توکن شما منقضی شده یا اشتباه وارد شده است. حتماً آن را در هدر Authorization بررسی کنید.
• خطای 429 (Too Many Requests): نرخ درخواست‌های شما بیش از حد مجاز است. لطفاً بین هر درخواست، وقفه کوتاهی (Rate Limiting) ایجاد کنید.
• خطای 500 (Internal Server Error): این یک خطای موقت در سمت سرور است. چند دقیقه صبر کنید و دوباره تلاش کنید.

نکته دوستانه: همیشه لاگ‌های خروجی را در محیط توسعه (Development) فعال نگه دارید تا در صورت بروز خطا، سریع‌تر منبع مشکل را پیدا کنید.

---

۵. سوالات متداول (FAQ)

آیا امکان دریافت لیست قیمت‌ها به صورت دسته‌ای (Bulk) وجود دارد؟
بله، با استفاده از متد POST /v1/bulk-pricing می‌توانید لیست کدهای فنی خود را ارسال کرده و قیمت‌های لحظه‌ای را دریافت کنید.

آیا کالاتک برای پروژه‌های کوچک مناسب است؟
صد در صد. ما در کالاتک از استارتاپ‌ها تا صنایع بزرگ را پشتیبانی می‌کنیم. سادگی در پیاده‌سازی، نقطه قوت ماست.

چگونه می‌توانم از تغییرات موجودی مطلع شوم؟
سیستم Webhook ما به شما این امکان را می‌دهد که با ثبت URL خود، در زمان تغییر وضعیت موجودیِ اقلامِ پرمصرف، نوتیفیکیشن دریافت کنید.

---

تجربه شخصی من در استفاده از این سیستم این است که همیشه سعی کنید کدهای فنی دقیق (Part Numbers) را ارسال کنید تا با کمترین خطا، دقیق‌ترین خروجی را دریافت کنید. در صورت بروز هرگونه مشکل فنی پیچیده‌تر، تیم پشتیبانی وب‌سایت کالاتک به خوبی پاسخگوی سوالات شما هستند.