מפתחים

הטמעת אלמנטים

חבר את ממשק המשתמש החתום למוצר React שלך עם פרימיטיבים מוקלדים - ספק + סטטוס + חותם + רכיבי לכידת חתימה שאתה מעבד בתוך מעטפת הדף שלך.

שלב אלמנטים בארבעה שלבים

  1. 1

    התקן את החבילה

    הוסף את @endossed/elements לפרויקט React 18+ שלך. Deps של עמיתים הם React ו-React DOM בלבד - ללא התפשטות של ספק SDK.

  2. 2

    טביעו אסימון הפעלת חתימה בצד השרת

    מה-backend שלך, POST /api/signing-sessions עם מזהה המעטפה + דוא"ל לחתום. התגובה מכילה אסימון סשן חתימה קצר מועד בהיקף של אותו חותם.

  3. 3

    עטפו את מסלול החתימה ב-<EndorsedProvider>

    הספק נושא את תצורת ה- API שלך לתוך הפרימיטיבים - ללא קידוח אבזר. ממש את אסימון ההפעלה עם useSigningSession() ועבד את <EnvelopeStatus>, <SignerInfo> ו-<SignatureField> בתוך הפריסה שלך.

  4. 4

    טפל בהגשת חתימה + התקשרויות חוזרות לסטטוס

    useSignatureSubmit() מפרסם את החתימה שנלכדה אל /api/signing-sessions/:id/signature. האזן למעברי סטטוס ונתב את החותם לדפי הצלחה/סירוב משלך כאשר SigningSessionStatus מתהפך.

דוגמה להטמעה מינימלית

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

tsx
import {
  EndorsedProvider,
  EnvelopeStatus,
  SignerInfo,
  SignatureField,
  useSigningSession,
} from '@endorsed/elements';

// 1. Wrap once at the app root (or per-signing-route).
export function App({ children }: { children: React.ReactNode }) {
  return (
    <EndorsedProvider
      baseUrl={process.env.NEXT_PUBLIC_ENDORSED_BASE_URL}
      // No API key in the browser. The provider only holds config.
    >
      {children}
    </EndorsedProvider>
  );
}

// 2. Render the signing surface. Compose these primitives into your
//    own page shell — headers, footers, and layout stay yours.
export function SigningPage({ sessionToken }: { sessionToken: string }) {
  const { status, envelope, signer } = useSigningSession(sessionToken);

  if (status === 'loading') return <p>Loading signing session…</p>;
  if (status === 'expired' || status === 'revoked') return <p>This link has expired.</p>;

  return (
    <section>
      <EnvelopeStatus value={envelope.status} />
      <SignerInfo values={{ name: signer.name, email: signer.email }} />
      <SignatureField
        onSubmitted={(result) => {
          // Advance your product state — redirect, mark task done, etc.
          console.log('Signature captured', result.signatureId);
        }}
      />
    </section>
  );
}

Elements שולח פרימיטיבים הניתנים לחיבור (ספק, תצוגת סטטוס/חתימה, לכידת חתימה). חבר את הפרימיטיבים שלמעלה או הטמע את החותם המתארח באמצעות כתובת האתר של הפעלת החתימה.

איזה ידיות להטביע בשבילך

📄

עיבוד מסמכים

PDF עיבוד, זום, גלילה וניווט בעמודים - חוצה דפדפנים, כולל ספארי לנייד.

✍️

לכידת חתימה

צייר, הקלד או העלה חתימה. חווית לכידה עקבית בין מכשירים ללא מוזרויות דפדפן.

🔐

אימות זהות בדיקת

OTP מטופלת בתוך ההטמעה. לא נדרש ממשק משתמש אימות נפרד במוצר שלך.

📋

ניווט בשטח

ניווט מודרך שדה אחר שדה עם אכיפה בשדה נדרש לפני ההגשה מותרת.

שאלות נפוצות

אלמנטים מוטמעים - בתוך המוצר שלך

משטח החתימה מוצג בדומיין שלך עם המותג שלך. מסגרת המוצר שלך, הכותרת שלך, הניווט שלך - EndorsedSign מטפל באינטראקציה של המסמך והשדה.

רשימת מסמכי חותמים בפורטל הלקוחות עם סטטוסים ופעולות מאוכלסים
אלמנטים משובצים בתוך מוצר SaaS בדיוני. משטח החתימה יושב בתוך כרום המוצר - ללא הפניה מחדש, ללא iframe, ללא מיתוג EndorsedSign גלוי.

נסה את אלמנטים בדייר ארגז החול שלך

תבע ארגז חול דרך ההתחלה המהירה, צור אסימון של סשן חתימה מהקצה האחורי שלך, ושחרר את הפרימיטיבים שלמעלה לכל אפליקציית React 18+.