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 נוצר מתוך חשבון קיים. אין עדיין חשבון? השאירו פרטים ונחזור אליכם.