סקירת נקודות הקצה
הרפרנס המלא — עם דוגמאות בקשה ותשובה, curl ו-JavaScript לכל נקודה — נמצא בעמוד API ← תיעוד באפליקציה. כאן המפה.
הבסיס
GET https://vision.org.il/wa/api/v1.php?r=leads
Authorization: Bearer wab_live_xxxxxxxx_................ניתוב: api/v1.php?r=leads/12 (קנוני), או api/v1/leads/12 כשמופעל mod_rewrite. כל התשובות JSON; שגיאה = {"error":{"code":"...","message":"..."}} עם קוד HTTP מתאים: 401 מפתח, 402 תוכנית או מכסה, 403 הרשאה, 404, 422 קלט, 429 קצב.
| נקודה | הרשאה | מה |
|---|---|---|
GET me | קריאה | פרטי החשבון, המפתח והיכולות המופעלות. |
GET contacts · GET contacts/{id} | קריאה | אנשי קשר, מצב הסכמה, שלב. |
GET leads · POST leads · GET/PATCH leads/{id} | קריאה / כתיבה | לידים: רשימה, יצירה, פרטים, שינוי שלב. |
GET availability | קריאה | משבצות פנויות לפי הזמינות ביומן. |
GET/POST appointments · GET/DELETE appointments/{id} | קריאה / כתיבה | פגישות: רשימה, קביעה, פרטים, ביטול. |
GET calls · POST calls | קריאה / שיחות | יומן שיחות עם סיכומים; הזמנת שיחה יוצאת של המזכירה. |
POST messages | כתיבה | שליחת הודעת וואטסאפ — באותם שערים כמו הפאנל (הסרה, חלון 24 השעות, תבניות, מכסה). |
GET events | קריאה | מסירות ה-webhook האחרונות ומצבן. |
כללים
- קצב: 120 בקשות לדקה למפתח (כותרות
X-RateLimit-*ו-Retry-After). Idempotency-Keyל-POST — אותה בקשה פעמיים בתוך 24 שעות מחזירה את אותה תשובה בלי ליצור כפילות.- CORS פתוח ל-GET בלבד; כתיבה — מהשרת שלכם.
נקודות קצה ציבוריות (בלי מפתח API)
| כתובת | למה |
|---|---|
https://vision.org.il/wa/voice_api.php | Speed-to-lead — טופס ← שיחה. מאומת ב-lead token. |
https://vision.org.il/wa/book.php?t=<slug> | דף ההזמנה הציבורי. |
https://vision.org.il/wa/webhook.php | הודעות נכנסות מ-Meta. מאומת בחתימת האפליקציה. |
https://vision.org.il/wa/voice_webhook.php | אירועי שיחה וכלים מספקית הקול. מאומת בסוד שבכתובת. |
https://vision.org.il/wa/billing_webhook.php | אירועי תשלום. מאומת בחתימת Stripe. |