מפתחים

ארגז חול

One API מספקת דייר ארגז חול מבודד, מטביעה מפתח API וחותמת הדגמה - ללא תור לגישה מוקדמת, ללא הגדרה ידנית.

מה נשלח כאשר אתה תובע ארגז חול

זרימת ארגז החול היא מצב בנקודת הקצה הסטנדרטית של רישום בשירות עצמי. כל מה שאתה מקבל הוא דייר אמיתי בפלטפורמה האמיתית - רק מסומן ''isSandbox: true'' ומוכן מראש כדי שה''תלתל'' הראשון שלך יצליח.

🏷️

דייר מבודד

דייר חדש עם השם שבחרת, המסומן ''isSandbox: true''. מפתחות API של ארגז חול לעולם אינם פועלים נגד דייר אחר, ואף מפתחות של דייר אחר לא פועלים נגד שלך. מפתח

🔑

API הוחזר פעם אחת

תגובת הרישום כוללת את מקש ה-esk_test_…'' המלא. הוא מוצג פעם אחת - אחסן אותו במנהל סודי השרת שלך, או צור אחר מ-Admin → Developer → API Keys.

👤

חותם הדגמה מפותח

שיא לקוח אחד (`Sandbox-signer-{yourTenantId}`) נוצר מראש. כאשר הזרימה מצליחה, ''sampleTemplateId'' נכלל כך שהקריאה הראשונה לשרת יכולה להיות יצירה מתבנית.

🆓

תוכנית חינמית, ללא הגדרת חיוב

דיירי ארגז חול נעולים לצד השרת של התוכנית החינמית. הרישום אף פעם לא נוגע בצינור החיוב, ו-''planId'' בגוף הבקשה מתעלם כאשר ''מצב: sandbox'' מוגדר.

🔔

Webhooks + קונסולת מפתחים

רשום נקודות קצה ב-Admin → מפתחים → Webhooks תוך כדי כניסה. הפעל מחדש משלוחים שנכשלו ובדוק בקשות API ב-Admin → מפתח → מסוף.

⏳

תפוגה מייעצת ל-30 יום

הדייר נושא רמז `expiresAt` (כרגע מידע - האכיפה היא מעקב). שום דבר לא נמחק אוטומטית היום; השדה נמצא שם עבור עבודת הניקיון העתידית.

תבע ארגז חול בבקשה אחת

דרישות מוקדמות: כתובת אימייל חוקית וסיסמה של 8+ תווים. פלט צפוי: HTTP 201 עם `tenantId` שלך, `sandbox.apiKey` (מוצג פעם אחת), ו-`demoCustomerId` המושב.

bash
curl -sS -X POST https://api.endorsedsign.com/api/auth/register \
  -H 'Content-Type: application/json' \
  -d '{
    "tenantName": "Acme Dev Sandbox",
    "adminEmail": "you@acme.example",
    "password": "your-strong-password",
    "mode": "sandbox"
  }' | jq '.data | { tenantId, sandbox }'

# {
#   "tenantId": "acme-dev-sandbox",
#   "sandbox": {
#     "apiKey": "esk_test_…",             # capture this now — shown once
#     "keyPrefix": "esk_test_…",
#     "keyId": "…",
#     "scopes": ["documents:write", …],
#     "demoCustomerId": "sandbox-signer-acme-dev-sandbox",
#     "demoCustomerName": "Sandbox Signer",
#     "expiresAt": "2026-…"
#   }
# }

אמת את דוא"ל המנהל שלך מתיבת הדואר הנכנס שלך לפני הכניסה ל-Admin. מקש API פועל באופן מיידי - אימות משער רק את הקונסולה האנושית.

מארגז חול לייצור

  1. 1

    תבע את ארגז החול שלך

    POST /api/auth/register with `mode: sandbox`. Capture the returned API key in your secret store.

  2. 2

    התקשר ל- API עם מפתח ארגז החול

    אשר את GET /api/v1/zapier/auth/test, ולאחר מכן צור מתוך תבנית ושלח לחתימה. רשמו webhooks ב-Admin → מפתח → Webhooks וצפו במשלוחים בקונסולה.

  3. 3

    עיין ברשימת הבדיקה לאינטגרציה

    אשר את אימות החתימה webhook, רישום מזהה מתאם ואי-כוח. רשימת בדיקה מלאה במסוף המפתחים תחת ניהול → מפתח.

  4. 4

    הירשם להפקה

    כשתהיה מוכן, רשום דייר ייצור נפרד דרך אותה נקודת קצה עם ''מצב: ייצור'' (או ממשק המשתמש הרגיל של ההרשמה). דייר ארגז החול שלך נשאר במקום כדי שתוכל להמשיך לבדוק.

שאלות נפוצות

תבע את ארגז החול שלך בשיחה אחת

נקודת הקצה פעילה היום. גוף התגובה כולל מפתח `esk_test_` שתוכל לאשר מהשרת שלך.