דוגמאות שימוש ב-API

דוגמאות שימוש ב-API של Hostey

מדריך זה מציג דוגמאות מעשיות לשימוש ב-API לתרחישים נפוצים. כל הדוגמאות מניחות שהגדרתם מפתח API (ראו מדריך "התחלת עבודה עם ה-API").

רשימת שירותים פעילים

שליפת כל השירותים הפעילים בחשבון:

curl -X GET https://hostey.co.il/api/v1/services \
  -H "Authorization: Bearer YOUR_API_KEY"

תשובה לדוגמה:

{
  "data": [
    {
      "id": "svc-1",
      "productName": "אחסון עסקי",
      "type": "SHARED_HOSTING",
      "status": "ACTIVE",
      "domain": "example.co.il",
      "nextDueDate": "2026-04-15",
      "price": 49.90,
      "billingCycle": "MONTHLY"
    },
    {
      "id": "svc-2",
      "productName": "VPS Pro",
      "type": "VPS",
      "status": "ACTIVE",
      "ipAddress": "185.199.108.1",
      "nextDueDate": "2027-01-01",
      "price": 1999.00,
      "billingCycle": "YEARLY"
    }
  ]
}

פרטי שירות ספציפי

curl -X GET https://hostey.co.il/api/v1/services/svc-1 \
  -H "Authorization: Bearer YOUR_API_KEY"

פתיחת פנייה לתמיכה

ניתן לפתוח פנייה באמצעות ה-API, למשל מתוך מערכת ניטור חיצונית:

curl -X POST https://hostey.co.il/api/v1/tickets \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "שרת VPS לא מגיב",
    "message": "מערכת הניטור שלנו זיהתה שהשרת לא מגיב מזה 10 דקות. IP: 185.199.108.1",
    "priority": "HIGH",
    "serviceId": "svc-2"
  }'

תשובה לדוגמה:

{
  "id": "ticket-123",
  "subject": "שרת VPS לא מגיב",
  "status": "OPEN",
  "priority": "HIGH",
  "createdAt": "2026-03-21T10:30:00Z"
}

סקריפט ניטור פשוט (Python)

דוגמה לסקריפט שבודק את סטטוס כל השירותים ושולח התראה אם שירות לא פעיל:

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://hostey.co.il/api/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

# שליפת שירותים
response = requests.get(f"{BASE_URL}/services", headers=headers)
services = response.json()["data"]

# בדיקת סטטוס
for service in services:
    if service["status"] != "ACTIVE":
        print(f"Warning: {service['productName']} is {service['status']}")

        # פתיחת פנייה אוטומטית
        requests.post(
            f"{BASE_URL}/tickets",
            headers=headers,
            json={
                "subject": f"שירות {service['productName']} לא פעיל",
                "message": f"סטטוס: {service['status']}. נדרשת בדיקה.",
                "priority": "HIGH",
                "serviceId": service["id"],
            }
        )

שליפת פניות פתוחות (Node.js)

const API_KEY = process.env.HOSTEY_API_KEY;

async function getOpenTickets() {
  const response = await fetch(
    'https://hostey.co.il/api/v1/tickets',
    {
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json',
      },
    }
  );

  const { data } = await response.json();
  const openTickets = data.filter(t => t.status === 'OPEN');

  console.log(`פניות פתוחות: ${openTickets.length}`);
  openTickets.forEach(ticket => {
    console.log(`- [${ticket.id}] ${ticket.subject}`);
  });
}

getOpenTickets();

שימוש ב-Webhooks

בנוסף ל-API, ניתן להגדיר Webhooks שישלחו התראות אוטומטיות לשרת שלכם כאשר מתרחשים אירועים (שירות הושהה, חשבונית הונפקה, פנייה נענתה). הגדרת Webhooks דרך: פורטל > חשבון > Webhooks.

טיפים

• שמרו את מפתח ה-API במשתנה סביבה, לא בקוד
• טפלו בשגיאות 429 (Rate Limit) עם חזרה מדורגת (exponential backoff)
• בדקו תמיד את קוד התשובה לפני עיבוד הנתונים
• תיעוד מלא של ה-API זמין בעמוד "מפתחים" באתר