מפרט OpenAPI: חיבור אוטומטים ל-CRM, Postman או קוד שנוצר לבד

מעבר לרפרנס הקריא בעמוד API ← תיעוד, כל ה-API מתועד גם כקובץ מפרט מכונה בתקן OpenAPI 3.1 — כדי לייבא ל-Postman/Insomnia, לחבר CRM שיודע לקרוא OpenAPI, או ליצור קוד לקוח (client) אוטומטית בכל שפה.

GET https://vision.org.il/wa/api/v1.php?r=openapi.json

הכתובת ציבורית ולא דורשת מפתח (כדי שאפשר יהיה לחקור ולייבא לפני שיוצרים מפתח), פתוחה ל-CORS ומחזירה JSON תקני עם כל הנקודות, הפרמטרים, סכמות הבקשה/תשובה וקודי השגיאה — בדיוק כפי שהם מתועדים בעמוד עצמו, כי שניהם נוצרים מאותו מקור. כותרת X-WABOT-Version על כל תשובה מציינת את גרסת ה-API הנוכחית.

לשימוש בפועל צריך עדיין מפתח API בכותרת Authorization — המפרט עצמו פתוח, אבל הקריאות שהוא מתאר דורשות אימות ומוגבלות לתוכניות Business ומעלה, בדיוק כמו שאר ה-API.