אימות (Authentication)

כל בקשה לAPI מאומתת עם x-api-key header. המפתח זמין בדף ההגדרות:

x-api-key: YOUR_API_KEY_HERE

אותו מפתח עובד עבור כל הדומיינים המחוברים לחשבון. אין צורך במפתחות נפרדים.

Base URL

https://link.botomat.co.il

נקודות קצה עיקריות

דוגמאות עבודה

cURL — קיצור בסיסי

curl -X POST https://link.botomat.co.il/shorten \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "original_url": "https://example.com/my-long-page",
    "custom_slug": "promo",
    "domain": "go.mysite.com"
  }'

JavaScript (Node.js / fetch)

const res = await fetch('https://link.botomat.co.il/shorten', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.BOTOMAT_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    original_url: 'https://example.com/page',
    custom_slug: 'sale25',
    is_permanent: true
  })
});
const data = await res.json();
console.log(data.slug);  // → 'sale25'

Python (requests)

import requests

resp = requests.post(
    'https://link.botomat.co.il/shorten',
    headers={'x-api-key': 'YOUR_API_KEY'},
    json={
        'original_url': 'https://example.com/page',
        'custom_slug': 'demo',
        'folder_path': ['קמפיינים', 'יוני 2026']
    }
)
print(resp.json())

כללי ניתוב דינמיים ב-API

{
  "original_url": "https://example.com/main-page",
  "custom_slug": "limited-offer",
  "rules": [
    {
      "type": "click_count",
      "value": "100",
      "destination": "https://example.com/sold-out-page"
    },
    {
      "type": "date_after",
      "value": "2026-07-01T00:00",
      "destination": "https://example.com/post-campaign"
    }
  ]
}

קבלת סטטיסטיקות

curl https://link.botomat.co.il/links/promo/stats?days=30 \
  -H "x-api-key: YOUR_API_KEY"

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

תיקיות ב-API

שני אופנים לציין תיקייה ביצירת לינק:

1. folder_id — מזהה מספרי של תיקייה קיימת.
2. folder_path — מערך שמות, המערכת תיצור תיקיות חדשות אם לא קיימות.

{
  "original_url": "https://example.com",
  "folder_path": ["לקוחות", "אקמה בע\"מ", "ינואר 2026"]
}

אינטגרציה עם Zapier / Make

אין אינטגרציה רשמית, אבל הכל עובד דרך פעולת "Webhook" / "HTTP":

1. Zapier: השתמשו ב-"Webhook by Zapier" → POST → URL: https://link.botomat.co.il/shorten
2. הוסיפו header: x-api-key עם המפתח שלכם.
3. שלחו payload כמו בדוגמאות למעלה.
4. השתמשו ב-slug מהתגובה בצעדים הבאים.

קודי שגיאה

• 200 / 201: הצלחה
• 400: בקשה לא תקינה (חסר שדה / סלאג לא חוקי)
• 401: חסר API key או שגוי
• 402: חרגתם מכמות הלינקים החודשית
• 403: פעולה שדורשת שדרוג תוכנית (למשל סלאג מותאם בחינם)
• 404: לינק לא נמצא
• 409: כפילות (סלאג קיים)

Rate Limits

כרגע אין rate limit נוקשה — אבל אנא הקפידו לא לעבור על ~10 בקשות לשנייה למשתמש כדי שלא נתקעו את החשבון אוטומטית.

סיכום

Botomat Link API הוא REST פשוט, מתועד במלואו עם תיעוד אינטראקטיבי ב-/docs וגם דרך Swagger ב-/swagger. אם נתקעתם או צריכים פיצ'ר חסר — כתבו לנו ב-botomat.co.il.