1. סקירה כללית

Clinikit API מאפשר למערכות חיצוניות, כמו Make.com, Google Calendar, טפסים, מערכות CRM חיצוניות או אפליקציות, ליצור ולעדכן נתונים בתוך 1net.me.

ה־API בנוי כנקודת כניסה אחת שמקבלת את סוג הישות ואת הפעולה הרצויה.

הישויות הנתמכות במסמך זה:

2. אימות והרשאות

כל בקשה חייבת לכלול apiCode. הערך הוא מזהה הלקוח או הרישיון במערכת 1net.me.

3. מבנה בקשה כללי

יש לשלוח בקשת POST בפורמט JSON.

POST https://admin.1net.me/api/clinikit.aspx
Content-Type: application/json

מבנה בסיסי

{
  "apiCode": "LICENSE_SN",
  "entity": "appointment",
  "action": "upsert"
}

4. Appointments, תורים

השימוש המרכזי הוא סנכרון תורים ממערכת חיצונית אל Clinikit, לדוגמה Google Calendar דרך Make.com.

4.1 יצירה או עדכון תור, appointment.upsert

אם קיים תור עם אותו externalEventId, המערכת תעדכן אותו. אם לא קיים, המערכת תיצור תור חדש.

{
  "apiCode": "LICENSE_SN",
  "entity": "appointment",
  "action": "upsert",
  "source": "Google",
  "externalEventId": "google_event_id_123",
  "calendarId": 5,
  "title": "Initial consultation",
  "notes": "Created from Google Calendar via Make",
  "startUtc": "2026-05-19T10:00:00Z",
  "endUtc": "2026-05-19T10:30:00Z",
  "statusCode": "Booked",
  "customer": {
    "firstName": "Nir",
    "lastName": "Millman",
    "mobile": "0500000000",
    "email": "client@example.com"
  }
}

4.2 ביטול תור, appointment.cancel

{
  "apiCode": "LICENSE_SN",
  "entity": "appointment",
  "action": "cancel",
  "source": "Google",
  "externalEventId": "google_event_id_123"
}

המערכת תחפש תור לפי externalEventId ותסמן אותו כמבוטל.

5. Leads, יצירת ליד

פעולה זו מיועדת ליצירת ליד חדש במערכת, בדומה ל־API הישן של leads.aspx אך דרך API מאוחד.

{
  "apiCode": "LICENSE_SN",
  "entity": "lead",
  "action": "create",
  "firstName": "Nir",
  "lastName": "Millman",
  "mobile": "0500000000",
  "email": "lead@example.com",
  "platform": "Facebook",
  "campaignName": "May Campaign",
  "adName": "Lead Ad 1",
  "additional": "Any extra data"
}

6. Customers, לקוחות

פעולת customer.upsert מיועדת ליצור לקוח חדש או לעדכן לקוח קיים לפי טלפון או מייל.

{
  "apiCode": "LICENSE_SN",
  "entity": "customer",
  "action": "upsert",
  "firstName": "Nir",
  "lastName": "Millman",
  "mobile": "0500000000",
  "email": "customer@example.com",
  "notes": "Imported from external CRM"
}

7. מבנה תשובות

תשובה תקינה

{
  "ok": true,
  "entity": "appointment",
  "action": "upsert",
  "mode": "updated",
  "appointmentId": 123
}

תשובת שגיאה

{
  "ok": false,
  "errorCode": "MISSING_API_CODE",
  "message": "apiCode is required"
}

8. שגיאות נפוצות

9. דוגמת שימוש ב־Make.com

בתרחיש Google Calendar אל Clinikit:

1. מודול Google Calendar מאזין לאירוע חדש או עדכון אירוע.
2. מודול HTTP שולח POST אל https://admin.1net.me/api/clinikit.aspx.
3. ב־Body בוחרים Raw JSON.
4. מגדירים Header: Content-Type: application/json.

{
  "apiCode": "LICENSE_SN",
  "entity": "appointment",
  "action": "upsert",
  "source": "Google",
  "externalEventId": "{{Google Event ID}}",
  "title": "{{Summary}}",
  "startUtc": "{{Start Date}}",
  "endUtc": "{{End Date}}",
  "statusCode": "Booked"
}

10. דגשים חשובים למטמיע

• יש לשלוח בקשות ב־POST בלבד.
• מומלץ לשלוח תמיד JSON תקין עם Content-Type: application/json.
• בסנכרון מול Google חובה לשלוח externalEventId.
• אין לשלוח את אותו אירוע בלי מזהה חיצוני, כדי לא ליצור כפילויות.
• ביטול תור מתבצע דרך entity=appointment ו־action=cancel.
• יש לשמור לוג בצד המטמיע לכל בקשה ותשובה לצורך בדיקות.