🏪 قیمتهات رو یهجا برای «تهش چنده؟» بفرست
برای فروشگاههای اینترنتی و پیجهای اینستاگرامی. بهجای اینکه ما سایتت رو بگردیم، خودت قیمتها رو یکجا میفرستی؛ ما هر کالا رو با کاتالوگمون تطبیق میدیم، تو تطبیق رو تأیید میکنی و بعد از بررسی ادمین، پیشنهادت به خریدارهای کانال و ربات نشون داده میشه.
درخواست همکاری در رباتچطور شروع کنم؟
- تو ربات @taheshchande_bot دستور
/shopرو بزن و «🌐 سایت» یا «📸 پیج اینستاگرام» رو انتخاب کن. - اطلاعات هویتی رو کامل کن (نام فروشگاه، نام صاحب، کد ملی، کارت برای تطبیق هویت، موبایل — با کد پیامکی تأیید میشه). اطلاعات رمزنگاریشده نگه داشته میشه و شمارهی کامل کارت ذخیره نمیشه.
- بعد از تأیید، تو ربات یه کلید API میگیری (فقط یک بار نشون داده میشه). بدون برنامهنویسی: یه فایل اکسل/CSV تو ربات بفرست (
/sheet)، یا از/offerو صفحهی/myshopاستفاده کن. - قیمتها رو بفرست، تطبیق با کاتالوگ رو تأیید کن، و منتظر بررسی ادمین بمون.
API — فرستادن همهی قیمتها در یک درخواست
آدرس: https://api.taheshchande.ir/v1/partner/items
احراز هویت: هدر Authorization: Bearer pk_…
محدودیت: تا ۱٬۰۰۰ کالا در هر درخواست؛ ۱۲۰ درخواست در دقیقه؛ برای هر فروشگاه در هر ساعت ۶۰ بار فرستادن فهرست و رویهم ۱۰٬۰۰۰ کالا (بیشتر از این 429 با retry-after). فقط https.
curl -X POST https://api.taheshchande.ir/v1/partner/items \
-H "Authorization: Bearer pk_XXXXXXXX" -H "Content-Type: application/json" \
-d '{
"items": [
{ "sku": "A56-256",
"title": "گوشی سامسونگ Galaxy A56 ۲۵۶ گیگ",
"url": "https://myshop.ir/p/a56",
"price_toman": 18500000,
"in_stock": true,
"valid_until": "2026-11-30T23:59:00+03:30",
"ref_url": "https://www.digikala.com/product/dkp-13579246/" }
]
}'
| فیلد | توضیح |
|---|---|
sku | شناسهی کالا تو سیستم خودت (ثابت بمونه) |
title | اسم کالا |
url | صفحهی خرید همین کالا تو سایت یا پست اینستاگرامت |
price_toman | قیمت فروش امروز به تومان (عدد صحیح) |
in_stock | موجوده؟ (پیشفرض true) — کالای ناموجود نمایش داده نمیشه و قیمت زندهش همون لحظه برداشته میشه |
valid_until (اختیاری) | تا کی این قیمت رو تضمین میکنی (ISO 8601 با منطقهی زمانی). بعدش نمایش داده نمیشه؛ حداکثر ۳۰ روز. نفرستی یعنی «تا قیمت بعدی». فرستادنِ دوبارهی همون قیمت، نمایشش رو تمدید میکنه. |
ref_url (پیشنهادی) | لینک همین کالا تو دیجیکالا یا ترب — دقیقترین راه تطبیق |
dkp، image_url | اختیاری |
{ "accepted": 1, "unchanged": 0, "deferred": 0,
"items": [ { "sku": "A56-256", "match_status": "suggested",
"suggestions": [ { "dkp": 13579246, "title": "گوشی سامسونگ Galaxy A56 ۲۵۶ گیگ", "score": 1 } ],
"waiting_review": true } ] }
- همون فهرست رو هر وقت قیمتی عوض شد دوباره بفرست؛ کالاهای بدون تغییر نادیده گرفته میشن و فقط قیمتهای جدید برای بررسی میرن.
- اگه قیمتِ کالایی که الان نمایش داده میشه عوض بشه، ناموجود بشه یا لینکش عوض بشه، همون لحظه از نمایش برداشته میشه تا قیمت جدید بررسی بشه.
- هر فروشگاه حداکثر ۲۰۰ قیمتِ منتظر بررسی داره؛ بیشترش
deferredبرمیگرده و با فرستادن بعدی خودکار وارد صف میشه.
بدون برنامهنویسی: فایل اکسل یا CSV
قالب رو بگیر و پرش کن: قالب اکسل (.xlsx) · CSV. بعد همون فایل رو تو ربات بفرست (یا تو صفحهی /myshop بارگذاری کن). قبل از ثبت، چیزی که از فایل فهمیدیم رو نشونت میدیم و تأیید میکنی.
| ستون | توضیح |
|---|---|
| نام کالا · قیمت (تومان) | لازم. قیمت ریالی هم قبوله اگه تو اسم ستون «ریال» بنویسی (یا موقع ثبت بگی). |
| لینک کالا یا پست | صفحهای که خریدار ازش میخره. پیج اینستاگرامی خالی بذاره، لینک پیجش رو میذاریم. |
| لینک همین کالا در دیجیکالا / ترب / ایمالز | دقیقترین راه تطبیق با کاتالوگ. |
| موجودی | «موجود» / «ناموجود» یا تعداد (۰ = ناموجود). خالی = موجود. |
| قیمت معتبر تا | مثلاً 1405/09/10 یا 1405/09/10 18:00 (شمسی یا میلادی). خالی = تا قیمت بعدی. |
| کد کالا · لینک عکس | اختیاری. |
- تو ترب میفروشی؟ خروجی محصولاتت از پنل ترب رو همونطور بفرست.
- تو دیجیکالا یا ایمالز میفروشی؟ فهرست کالاهات رو با لینک دیجیکالا/ایمالزِ هر کالا جلوش بفرست (یا خروجی پنل فروشندگان رو).
- ترتیب ستونها مهم نیست؛ ستونها رو از اسمشون پیدا میکنیم و ستون اضافه نادیده گرفته میشه. هر فایل تا ۵٬۰۰۰ کالا و ۳ مگابایت.
برای برنامهنویسها همون فایل با API هم قبوله:
POST /v1/partner/sheet
{ "filename": "prices.xlsx", "data_b64": "<base64 فایل>", "unit": "toman", "confirm": false, "full_list": false }
confirm: false فقط پیشنمایش برمیگردونه (چیزی ذخیره نمیشه)؛ confirm: true ثبت میکنه. با full_list: true یعنی «این فهرست کامله»: کالاهای موجودی که تو فایل نیستن ناموجود میشن و قیمتشون از نمایش برداشته میشه (missing_in_stock تو پیشنمایش تعدادشون رو میگه). هر خوندن فایل یه «فرستادن» از سهم ساعتی حساب میشه.
تطبیق با کاتالوگ
برای هر کالا تا ۳ پیشنهاد تطبیق برمیگردونیم. تطبیق درست رو تأیید کن (یا null اگه هیچکدوم نبود):
POST /v1/partner/items/A56-256/match
{ "dkp": 13579246 }
GET /v1/partner/items فهرست همهی کالاها، وضعیت تطبیق، اینکه کدوم قیمت الان نمایش داده میشه (live) و کدوم منتظر بررسیه (waiting_review) رو برمیگردونه.
قانونها
- هر قیمت جدید قبل از نمایش توسط ادمین بررسی میشه؛ پیشنهادهای فروشندهها همیشه با «قیمت اعلامشدهی فروشگاه» مشخص میشن.
- ادعای «ارزونترین بازار» فقط وقتی نوشته میشه که خودمون با بازار مقایسه کرده باشیم.
- قیمتی که تو صفحهت نیست، تخفیف ساختگی، یا کالای اشتباه = توقف همکاری. گزارش خریدارها بررسی میشه.
سؤال داری؟ تو ربات «💬 پشتیبانی» رو بزن.