ה-API של Buyro

1. מפתח

יוצרים מפתח בהגדרות, מפתחות API ושולחים אותו עם כל בקשה:

Authorization: Bearer byr_...

שמרו אותו בסוד. מפתח יכול ליצור לינקים ולקרוא את הנתונים שלכם. הוא לא יכול לשנות לאן הכסף הולך או למחוק את החשבון, ופרסום לערוצים נשאר אצל הבוט, כי רק טלגרם יכולה לאשר שהערוץ שייך לכם.

כל זה גם כקובץ OpenAPI, לכלים שיודעים לקרוא אותו (Make, Zapier, קוד שנוצר ממנו):

https://buyro.app/api/v1/openapi.json

2. יצירת לינק

שולחים כתובת של מוצר, ומקבלים את הלינק הקצר שלכם, עם פרטי המוצר והפוסט שהבוט היה מפרסם. המילים שלכם (note) פותחות את הפוסט; locale קובע עברית (he) או אנגלית (en).

curl -X POST https://buyro.app/api/v1/links \
  -H "Authorization: Bearer $BUYRO_KEY" \
  -H "content-type: application/json" \
  -d '{"url": "https://www.aliexpress.com/item/1005006123456789.html",
       "note": "קניתי, מעולה",
       "locale": "he"}'

התשובה (מקוצרת):

{
  "link": { "shortCode": "x7Ab3kQ", "shortUrl": "https://buyro.link/x7Ab3kQ",
            "monetized": true, "network": "aliexpress" },
  "product": { "title": "...", "priceMinor": 4990, "currency": "ILS", "imageUrl": "https://..." },
  "post": {
    "telegram": "🔥 <b>...</b>\n\n💰 <b>₪49.90</b> ...\n\n🛒 ... https://buyro.link/x7Ab3kQ",
    "whatsapp": "🔥 *...*\n\n💰 *₪49.90* ...\n\n🛒 ... https://buyro.link/x7Ab3kQ"
  }
}

post.telegram הוא HTML ל-sendMessage או sendPhoto עם parse_mode HTML. post.whatsapp כתוב בסימונים של וואטסאפ. לינקים לעלי אקספרס מרוויחים; חנות שעוד לא נתמכת עונה store_not_supported.

פרסום לערוץ

מפרסמים אחד הלינקים שלכם בערוץ שחיברתם, עכשיו או בזמן שתבחרו, עד 14 יום קדימה. את הערוץ מחברים פעם אחת בבוט, כי רק טלגרם יכולה לאשר שהוא שלכם, ואת ה-chatId שלו מחזירה רשימת הערוצים.

GET https://buyro.app/api/v1/me/channels

curl -X POST https://buyro.app/api/v1/me/posts \
  -H "Authorization: Bearer $BUYRO_KEY" \
  -H "content-type: application/json" \
  -d '{"shortCode": "x7Ab3kQ", "chatId": -1001234567890,
       "at": "2026-10-12T09:00:00+03:00"}'

הפוסט נכנס לתור ויוצא תוך דקה מהזמן שנקבע, באותו כרטיס שהבוט מפרסם, עם המילים והתמונה שלכם. את מה שבתור אפשר לראות ולבטל:

{ "id": "4f1c...", "chatId": -1001234567890, "channelTitle": "...", "shortCode": "x7Ab3kQ",
  "runAt": "2026-10-12T06:00:00.000Z" }

GET    https://buyro.app/api/v1/me/scheduled-posts
DELETE https://buyro.app/api/v1/me/scheduled-posts/{id}

עד 60 פוסטים בשעה. פוסט שנתקע מנסה שוב, ואם בכל זאת לא יצא, הבוט יודיע לכם.

בוואטסאפ אין דרך לפרסם בשבילכם. הכתובת הזו פותחת את וואטסאפ עם הפוסט של הלינק מוכן לשליחה, וטובה לכפתור בכלים שלכם:

https://buyro.app/api/v1/links/{code}/whatsapp

3. הדילים של היום

הדילים הכי טובים של היום, כל אחד עם כמה אתם מרוויחים על מכירה (creatorEarnMinor, באגורות או בסנטים). יוצרים לינק מה-url של דיל כדי לפרסם אותו.

curl "https://buyro.app/api/v1/deals?limit=20" -H "Authorization: Bearer $BUYRO_KEY"

4. הנתונים שלכם

קליקים, מכירות ורווחים לכל לינק, הסיכומים לפי סטטוס, והתשלומים שלכם.

GET https://buyro.app/api/v1/me/stats?limit=20&offset=0&q=
GET https://buyro.app/api/v1/me/earnings
GET https://buyro.app/api/v1/me/payouts

5. ניהול לינקים

להוציא לינק מהחנות (הוא ממשיך לעבוד איפה שכבר פרסמתם), לשלוח ישר לחנות, לשנות את המילים שלכם, או לקבל שוב את הכרטיס.

PATCH https://buyro.app/api/v1/links/{code}        {"hidden": true}  |  {"landing": "direct"}
PUT   https://buyro.app/api/v1/links/{code}/note   {"note": "..."}
GET   https://buyro.app/api/v1/me/links/{code}/card

מגבלות ושגיאות

עד 120 לינקים חדשים בשעה. שגיאה חוזרת עם קוד סטטוס וגוף שאומר מה קרה:

{ "error": "rate_limited", "retryAfter": 1800 }

• unauthorized המפתח חסר, שגוי או בוטל (401).
• invalid_url זו לא כתובת של מוצר (400).
• store_not_supported החנות הזו עוד לא מרוויחה ב-Buyro (422).
• rate_limited יותר מדי לינקים בשעה הזו; חכו את מספר השניות ב-Retry-After (429).
• suspended החשבון מוקפא; כתבו לתמיכה (403).
• channel_not_connected הלינק או הערוץ לא של החשבון הזה, או שהערוץ לא מחובר. מחברים ערוץ בבוט.
• channel_cannot_post לבוט אין הרשאת פרסום בערוץ. הוסיפו אותו שוב כמנהל עם הרשאת פרסום.
• too_far_ahead אפשר לתזמן עד 14 יום קדימה.