מה חושף API של PDF שלנו - זיכויים ומגבלות
דפי API נוטים לגדול מהר יותר ממשקי API. שלנו כעת מפרט רק את המסלולים שמסתיימים ללא דפדפן: חשבון, רדוק והשוואה. זה מכוון. נקודת קצה שאינה יכולה להשלים את זרימת העבודה שלה גרועה מאין נקודת קצה כלל.
מה חי היום
- קבל /v1/me - חשבון, תוכנית ויתרת אשראי חיה; זיכוי 1 לכל שיחה.
- POST /v1/redact-pdf - מצא דפוסים, טקסט או תמונות, והחזר עם PDF ערוך
apply=1. לְשַׁחְרֵר. - POST /v1/compare-pdf - סטטיסטיקות, בלוקים שהשתנו והבדלים מרכזיים בין שני קובצי PDF. לְשַׁחְרֵר.
שלושתם לוקחים מפתח נושא מהחשבון שלי. התוצאות הן JSON עם קישור להורדה שחי במשך שעתיים; מסמכי מקור לעולם אינם משתנים במקום.
מה לא ב-API
מה שה-API גובה היום
קיימים שלושה מסלולים בלבד: GET /v1/me עולה 1 אשראי, בעוד POST /v1/redact-pdf ו POST /v1/compare-pdf עלות 5 קרדיטים כל אחד. אין חיובי מיזוג או OCR API מכיוון שכלים אלה אינם נקודות קצה של API. התעריפים החיים הם על תוכניות ותמחור עמוד.
מדוע E-Signer אינו מסלול
חתימה היא תהליך עבודה של דפדפן פעמיים: השולח מציב שדות בדף, והנמען פותח קישור וחותם. לקוח HTTP אינו יכול לראות את הפריסה או להפעיל את הדף הזה, כך ש-"e-sign API" ייפסק לפני סיום העבודה. מעטפות חיות בלוח המחוונים E-Signer; ה-API לא יוצר או חותם אותם.
שמירת מפתחות וקבצים
התייחס למפתח API כאל סיסמה: מפתח אחד לכל יישום, סובב אותו אם הוא הודבק במאגר ציבורי, ולעולם אל תכניס אותו ל-JavaScript בצד הדפדפן. קבצים שהועלו הם עותקי עבודה זמניים עם מזהה שלא ניתן לנחש; הם לא חנות מסמכים. שמור את המקורות באחסון שלך והתייחס לתגובת ה-API כאל העותק הנגזר. ה דף אבטחה מפרט את הפקדים ואת חלון השמירה.
מה למדוד לפני שדרוג
עקוב אחר שלושה מספרים במשך חודש: שיחות מוצלחות, שיחות שנכשלו ויתרת האשראי בסוף. Redact והשוואה משולמים (5 זיכויים כל אחד), כך שחודש עמוס נראה במאזן; שיחות חשבון עולות 1. אם ניסיונות חוזרים או עליות שיא של חודשי אכן צורכים זיכויים, תוכנית גדולה יותר זולה יותר מאצווה שנכשלה. מכיוון שזיכויים לא מנוצלים מתגלגלים, חודש שקט אינו מבוזבז.
E-Signer הוא דפדפן בלבד. מישהו צריך למקם את שדות החתימה של הנמען בצורה ויזואלית, והנמען צריך לפתוח דף חתימה ולחתום עליו. לקוח HTTP לא יכול לעשות את שניהם, ולכן אין מסלול API ליצירה, חתימה, רשימה או סקר מעטפות. לוח המחוונים של E-Signer נשאר המקום הנכון לעבודה זו.
אותה בדיקה מסירה לעת עתה מיזוג, דחיסה, המרה ואת העורך מה-API: זרימת העבודה השימושית שלהם היא אינטראקטיבית ועתירת קבצים. הם נשארים חופשיים בדפדפן במקום להיות מפורסמים כנקודות קצה חצי עובדות.
איזה אשראי קונה
זיכויים הם היתרה ששולמה מראש המצורפת לחשבון מסחרי. כיום מסלולי ה-API בתשלום הם GET /v1/me ב-1 קרדיט ו-Redact and Compare ב-5 קרדיטים כל אחד. התוכניות עדיין כוללות קצבת אשראי חודשית, וזיכויים שלא נוצלו מתגלגלים במקום לפוג. אנו מציגים תעריפי API חיים על תוכניות ותמחור עמוד ולא לפרסם מחירים לכלי למסלולים שאינם קיימים.
מפתחות, מגבלות ובטיחות
מפתחות API מוצגים פעם אחת ומאוחסנים רק כ-hash. מפתח שבוטל מפסיק לפעול מיד. מגבלות תעריף לכל מפתח ולכל IP מענה 429 עם Retry-After, העלאות מוגבלות לפי גודל וספירת עמודים, וחשבון חסום או לא זכאי לא יכול להשתמש במפתח חי. ה דף API מתעד את שלושת המסלולים ואת שדות הבקשה שלהם.
מתחילים
צור חשבון, הפעל תוכנית מסחרית אם אתה צריך מפתחות API, ואז צור את המפתח ב'חשבון שלי' והתקשר GET /v1/me תחילה. אם כלי דפדפן יכול לעשות את העבודה, השתמש בכלי הדפדפן - הוא נשאר בחינם.