Mosaqo API
ממשק API ו-webhooks לאוטומציה של QR
Mosaqo API ציבורי משתמש במפתחות בהיקף של סביבת עבודה. התחל עם ההיקף המינימלי, השתמש ב-Idempotency-Key לכתיבה וכבד נסה שוב-אחרי כאשר שיעור מוגבל.
סקירה מהירה
מה זה משנה בפועל
01
אימות והיקפים
שלח את הסוד ב-X-Mosaqo-API-Key. ההיקפים הזמינים כוללים qr:read, qr:write, exports:read ו-analytics:read. מפתחות יכולים לפוג, להישלל או להשתמש ברשימת הרשאות IP.
- לעולם אל תציב סוד ב-JavaScript של הלקוח
- השתמש במפתח אחד לכל אינטגרציה
- סובב לאחר חשד לחשיפה
02
ניסיונות חוזרים של כתיבה בטוחה
יצירה ופרסום של בקשות דורשות Idempotency-Key בין 1 ל-128 תווים. השתמש שוב במפתח רק כדי לנסות שוב את המטען הזהה בתוך 24 שעות.
03
מגבלות תעריפים ושגיאות
ב-HTTP 429, קרא Retry-After ונסה שוב עם backoff. 401 מציין בדרך כלל מפתח חסר, בוטל, פג תוקפו, מוגבל או חסר היקף מספיק.
04
Webhooks
הירשם רק לאירועים הדרושים, קבל אותם ב-HTTPS והגיב במהירות. Mosaqo מתעד סטטוס מסירה ותומך בהפעלה חוזרת מסביבת העבודה.
FAQ
שאלות נפוצות
היכן נמצא חוזה ה-API המלא?
חוזה OpenAPI 3.1 מנוסח עם ה-API Mosaqo. צור מפתח בסביבת העבודה האינטרנטית והשתמש בחוזה שפורסם לפרטי נקודות הקצה.
השלב הבא