API PDF của chúng tôi thể hiện điều gì - Tín dụng và giới hạn
Các trang API có xu hướng phát triển nhanh hơn API. Hiện tại, chúng tôi chỉ liệt kê các tuyến kết thúc mà không cần trình duyệt: tài khoản, Làm lại và So sánh. Đó là cố ý. Một điểm cuối không thể hoàn thành quy trình làm việc của nó thì còn tệ hơn là không có điểm cuối nào cả.
Trực tiếp hôm nay có gì
- NHẬN /v1/tôi — tài khoản, kế hoạch và số dư tín dụng trực tiếp; 1 tín dụng cho mỗi cuộc gọi.
- BÀI ĐĂNG /v1/redact-pdf — tìm mẫu, văn bản hoặc hình ảnh và trả lại bản PDF đã được biên tập lại với
apply=1. Miễn phí. - BÀI ĐĂNG /v1/so sánh-pdf — số liệu thống kê, các khối đã thay đổi và những điểm khác biệt chính giữa hai tệp PDF. Miễn phí.
Cả ba đều lấy chìa khóa mang từ Tài khoản của tôi. Kết quả là JSON với liên kết tải xuống tồn tại trong hai giờ; bản gốc không bao giờ được sửa đổi tại chỗ.
Những gì không có trong API
API tính phí hôm nay như thế nào
Chỉ có ba tuyến đường tồn tại: GET /v1/me tốn 1 tín chỉ, trong khi POST /v1/redact-pdf và POST /v1/compare-pdf tốn 5 tín chỉ mỗi cái. Không có phí hợp nhất hoặc API OCR vì những công cụ đó không phải là điểm cuối API. Tỷ lệ trực tiếp là trên Kế hoạch và giá cả trang.
Tại sao E-Signer không phải là một lộ trình
Việc ký tên là một quy trình làm việc của trình duyệt diễn ra hai lần: người gửi đặt các trường trên trang và người nhận mở một liên kết và ký tên. Máy khách HTTP không thể xem bố cục hoặc vận hành trang đó, do đó, “API ký điện tử” sẽ dừng trước khi công việc kết thúc. Phong bì nằm trong bảng điều khiển E-Signer; API không tạo hoặc ký chúng.
Khóa và lưu giữ tập tin
Coi khóa API giống như mật khẩu: một khóa cho mỗi ứng dụng, xoay khóa nếu khóa đó đã được dán vào kho lưu trữ công cộng và không bao giờ đặt khóa đó vào JavaScript phía trình duyệt. Các tệp đã tải lên là bản sao làm việc tạm thời có id không thể đoán được; họ không phải là một cửa hàng tài liệu. Giữ bản gốc trong bộ lưu trữ của riêng bạn và coi phản hồi API là bản sao phái sinh. các Trang bảo mật liệt kê các điều khiển và cửa sổ lưu giữ.
Những gì cần đo trước khi nâng cấp
Theo dõi ba con số trong một tháng: cuộc gọi thành công, cuộc gọi thất bại và số dư tín dụng cuối cùng. Làm lại và So sánh được thanh toán (mỗi khoản 5 tín chỉ), vì vậy số dư sẽ hiển thị trong số dư một tháng bận rộn; phí cuộc gọi tài khoản là 1. Nếu số lần thử lại hoặc mức tăng đột biến trong tháng cao điểm làm tiêu tốn tín dụng, thì gói lớn hơn sẽ rẻ hơn so với gói không thành công. Bởi vì các khoản tín dụng chưa sử dụng sẽ được chuyển đổi nên một tháng yên tĩnh sẽ không bị lãng phí.
E-Signer chỉ dành cho trình duyệt. Ai đó phải đặt các trường chữ ký của người nhận một cách trực quan và người nhận phải mở trang ký và ký tên. Máy khách HTTP không thể làm được cả hai việc này, do đó không có lộ trình API nào để tạo, ký, liệt kê hoặc phong bì thăm dò ý kiến. Bảng điều khiển E-Signer vẫn là nơi thích hợp cho công việc đó.
Thử nghiệm tương tự hiện loại bỏ tính năng hợp nhất, nén, chuyển đổi và trình chỉnh sửa khỏi API: quy trình làm việc hữu ích của chúng mang tính tương tác và nặng về tệp. Chúng tồn tại miễn phí trong trình duyệt thay vì được quảng cáo là điểm cuối hoạt động nửa vời.
Tín dụng mua được gì
Tín dụng là số dư trả trước được đính kèm với tài khoản Thương mại. Ngày nay, các tuyến API trả phí duy nhất là GET /v1/me ở mức 1 tín chỉ và Biên tập và So sánh ở mức 5 tín chỉ mỗi bài. Các kế hoạch vẫn bao gồm trợ cấp tín dụng hàng tháng và các khoản tín dụng chưa sử dụng sẽ được chuyển đổi thay vì hết hạn. Chúng tôi liệt kê tỷ lệ API trực tiếp trên Kế hoạch và giá cả trang và không công bố giá mỗi công cụ cho các tuyến đường không tồn tại.
Chìa khóa, giới hạn và an toàn
Khóa API được hiển thị một lần và chỉ được lưu trữ dưới dạng hàm băm. Khóa bị thu hồi sẽ ngừng hoạt động ngay lập tức. Câu trả lời về giới hạn tốc độ trên mỗi khóa và mỗi IP 429 với Retry-After, nội dung tải lên bị giới hạn theo kích thước và số lượng trang, đồng thời tài khoản bị cấm hoặc không có quyền không thể sử dụng khóa trực tiếp. các trang API ghi lại ba tuyến đường và các trường yêu cầu của chúng.
Bắt đầu
Tạo một tài khoản, kích hoạt gói Thương mại nếu bạn cần khóa API, sau đó tạo khóa trong Tài khoản của tôi và gọi GET /v1/me đầu tiên. Nếu một công cụ trình duyệt có thể thực hiện công việc này, hãy sử dụng công cụ trình duyệt đó - nó vẫn miễn phí.