صندوق الرمل
واحد API يقوم باستدعاء مستأجر معزول في وضع الحماية، ويصك مفتاح API، ويزرع موقعًا تجريبيًا - لا توجد قائمة انتظار للوصول المبكر، ولا إعداد يدوي.
ما الذي يتم شحنه عندما تطالب بصندوق رمل
يعد تدفق وضع الحماية بمثابة وضع على نقطة نهاية تسجيل الخدمة الذاتية القياسية. كل ما تحصل عليه هو مستأجر حقيقي على النظام الأساسي الحقيقي - ما عليك سوى وضع علامة `isSandbox: true'' وتم تصنيفها مسبقًا حتى تنجح عملية `curl'' الأولى.
مستأجر معزول
مستأجر جديد بالاسم الذي اخترته، مع وضع علامة `isSandbox: true`. لا تعمل مفاتيح Sandbox API أبدًا ضد مستأجر آخر، ولا تعمل مفاتيح مستأجر آخر ضد مفاتيحك.
API تم إرجاع المفتاح مرة واحدة
يتضمن رد التسجيل مفتاح `esk_test_...` كاملاً. يتم عرضه مرة واحدة - قم بتخزينه في مدير الأسرار الخاص بخادمك، أو قم بنسخه مرة أخرى من المسؤول → المطور → API المفاتيح.
مُوقع تجريبي مُصنف
سجل عميل واحد (`sandbox-signer-{yourTenantId}`) تم إنشاؤه مسبقًا. عندما ينجح البذر، يتم تضمين `sampleTemplateId` حتى يمكن إنشاء استدعاء الخادم الأول من القالب.
خطة مجانية، بدون إعداد الفوترة
مستأجرو Sandbox مقيدون بجانب خادم الخطة المجانية. لا يمس التسجيل أبدًا مسار الفوترة، ويتم تجاهل "معرف الخطة" في نص الطلب عند تعيين "الوضع: وضع الحماية".
Webhooks + وحدة تحكم المطور
قم بتسجيل نقاط النهاية في المسؤول → المطور → Webhooks أثناء تسجيل الدخول. أعد تشغيل عمليات التسليم الفاشلة وافحص طلبات API في المسؤول → المطور → وحدة التحكم.
استشاري انتهاء الصلاحية لمدة 30 يومًا
يحمل المستأجر تلميحًا "انتهاء الصلاحية" (معلومات حاليًا - التنفيذ هو متابعة). لا يتم حذف أي شيء تلقائيًا اليوم؛ الحقل موجود لمهمة التنظيف المستقبلية.
اطلب صندوق الحماية بطلب واحد
المتطلبات الأساسية: عنوان بريد إلكتروني صالح وكلمة مرور مكونة من 8 أحرف أو أكثر. الإخراج المتوقع: HTTP 201 مع "tenantId"، و"sandbox.apiKey" (يظهر مرة واحدة)، و"demoCustomerId" المصنف.
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-…"
# }
# }تحقق من بريدك الإلكتروني الإداري من صندوق الوارد الخاص بك قبل تسجيل الدخول إلى المسؤول. يعمل المفتاح API على الفور — فالتحقق لا يؤدي إلا إلى دخول وحدة التحكم البشرية.
من وضع الحماية إلى الإنتاج
- 1
المطالبة بوضع الحماية الخاص بك
POST /api/auth/register with `mode: sandbox`. Capture the returned API key in your secret store.
- 2
اتصل بـ API باستخدام مفتاح وضع الحماية
أكد الحصول على /api/v1/zapier/auth/test، ثم قم بالإنشاء من القالب وإرساله للتوقيع. سجل webhooks في المسؤول → المطور → Webhooks وشاهد عمليات التسليم في وحدة التحكم.
- 3
راجع قائمة التحقق من التكامل
أكد webhook التحقق من التوقيع وتسجيل معرف الارتباط والعجز. قائمة التحقق الكاملة في وحدة تحكم المطور ضمن Admin → Developer.
- 4
اشترك في الإنتاج
عندما تكون جاهزًا، قم بتسجيل مستأجر إنتاج منفصل من خلال نفس نقطة النهاية باستخدام "الوضع: الإنتاج" (أو واجهة مستخدم التسجيل القياسية). يظل مستأجر Sandbox الخاص بك في مكانه حتى تتمكن من مواصلة الاختبار.
الأسئلة الشائعة
اطلب وضع الحماية الخاص بك بمكالمة واحدة
نقطة النهاية متاحة اليوم. يتضمن نص الاستجابة مفتاح `esk_test_` الذي يمكنك تأكيده من خادمك.