API למפתחים
מחברים את החנות, הקופה או המערכת הפנימית שלכם להפקת מסמכים. הדוגמאות כאן מוכנות להרצה, עם מפתח לדוגמה.
שימוש ב-API
דוגמה: חשבונית מס
curl -X POST https://billing.easyonline.co.il/api/v1/documents \
-H "Authorization: Bearer $BILLING_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"type":"tax_invoice","customer":{"name":"לקוח בע\"מ","taxId":"513456780"},"lines":[{"description":"שירות","qty":1,"unitPrice":1000}]}'
# Git Bash on Windows mangles Hebrew passed with -d.
# There, put the body in a UTF-8 file and send it as-is:
# curl -X POST ... --data-binary @doc.json• המפתח לא מוצג כאן — הוא נראה פעם אחת בלבד ביצירה. שמור אותו במשתנה סביבה
BILLING_KEY ולעולם לא בקוד צד-לקוח.• עברית בטרמינל של Windows: העברת JSON ישירות עם
-d שולחת את הטקסט בקידוד המקומי והוא מגיע כסימני שאלה. בדוגמאות למעלה הגוף עובר דרך קובץ או מקודד מפורש — בקוד אמיתי הבעיה לא קיימת.• Idempotency-Key: אותו מפתח עם אותו גוף מחזיר את אותו מסמך במקום להפיק שני.
מפתח API נוצר מתוך חשבון קיים. אין עדיין חשבון? השאירו פרטים ונחזור אליכם.