API לקיצור קישורים

קצרו קישורים ישירות מהאפליקציה, האתר או השרת שלכם. צרו מפתח API למטה, ואז קראו לנקודת קצה אחת.

מפתחות ה-API שלכם

אימות

שלחו את המפתח כ-Bearer token בכותרת Authorization. שמרו עליו בסוד - הוא כמו סיסמה.

Authorization: Bearer srt_your_key_here

יצירת קישור קצר

שלחו בקשת POST עם הכתובת הארוכה. בתשובה תקבלו את הקישור הקצר.

POST https://api.srt.co.il/api/v1/shorten

גוף הבקשה

url	חובה הכתובת הארוכה לקיצור.
slug	רשות סיומת מותאמת, למשל my-promo.
tag	רשות תווית קמפיין לניתוח הנתונים שלכם.

דוגמה

curl -X POST https://api.srt.co.il/api/v1/shorten \
  -H "Authorization: Bearer srt_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/a/very/long/link"}'

כל נקודות הקצה

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

נקודת קצה	הרשאה	מה זה עושה
`POST /shorten`	יצירת קישורים	יצירת קישור מקוצר
`GET /links`	קריאת קישורים	רשימת הקישורים שלך (חיפוש, מיון, עימוד)
`GET /links/:id`	קריאת קישורים	קבלת קישור בודד שלך
`GET /links/:id/analytics`	קריאת קישורים	סטטיסטיקת קליקים לקישור
`PATCH /links/:id`	ניהול קישורים	הפעלה/כיבוי, הפניה מחדש או תיוג
`DELETE /links/:id`	ניהול קישורים	מחיקת קישור

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

תשובה

בהצלחה תקבלו HTTP 201 ואת הקישור הקצר בשדה shortUrl.

{
  "ok": true,
  "data": {
    "shortCode": "AbC123",
    "shortUrl": "https://srt.co.il/AbC123",
    "destinationUrl": "https://example.com/a/very/long/link",
    "clickCount": 0,
    "createdAt": "2026-08-18T12:00:00.000Z"
  }
}

מגבלות קצב

עד 60 בקשות בדקה לכל מפתח. חריגה מחזירה HTTP 429 - המתינו רגע ונסו שוב.

שגיאות

כשלים מחזירים את קוד ה-HTTP המתאים וגוף JSON. קודים נפוצים: invalid_url, rate_limited, unauthorized.

{ "ok": false, "error": { "code": "invalid_url", "message": "..." } }

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