বিষয়বস্তুতে যান

চুক্তি ঢোকে, স্বাক্ষরিত হয়ে বেরোয়।

Bona Fide হলো API হিসেবে ই-স্বাক্ষর। একটি টেমপ্লেট ও আপনার ডেটা থেকে স্বাক্ষরের জন্য প্রস্তুত খাম তৈরি করুন, মানুষকে আপনার প্রোডাক্টের ভেতরে বা হোস্ট করা পৃষ্ঠায় স্বাক্ষর করতে দিন, আর পান এমন একটি সিল করা PDF, যা যে কেউ যাচাই করতে পারেন।

টেমপ্লেট

একটি PDF (বা Word ফাইল) আপলোড করে ফিল্ড বসান, অথবা Document মোডে চুক্তিটি লিখুন। ভেরিয়েবলগুলো একটি JSON Schema, তাই কিছু পাঠানোর আগেই API আপনার ডেটা যাচাই করে। প্রকাশিত হওয়ার পর ভার্সন আর বদলানো যায় না।

খাম

একটি POST /v1/envelopes আপনার ভেরিয়েবল দিয়ে টেমপ্লেট রেন্ডার করে এবং ভূমিকা ও ক্রম অনুযায়ী প্রাপকদের কাছে পাঠানো শুরু করে। ড্রাই রান, আইডেমপোটেন্সি কী এবং externalId দিয়ে ডুপ্লিকেট রোধ আগে থেকেই অন্তর্ভুক্ত।

স্বাক্ষর, আপনার পদ্ধতিতে

ইমেইল লিংক, হোস্ট করা পৃষ্ঠা, অথবা আপনার নিজের অ্যাপের ভেতরে <bf-signing> ওয়েব কম্পোনেন্ট (React ও Vue র‍্যাপারসহ), যার স্বল্পমেয়াদি, একবার-ব্যবহারযোগ্য সেশন আপনার ব্যাকএন্ড তৈরি করে।

যে কেউ যাচাই করতে পারেন এমন প্রমাণ

প্রতিটি সম্পন্ন নথি একটি পাবলিক টাইমস্ট্যাম্প অথরিটি থেকে PAdES ডকুমেন্ট টাইমস্ট্যাম্প পায়, আর এর ফিঙ্গারপ্রিন্ট যায় একটি Merkle ট্রি-তে, যার রুটগুলো Bona Fide, Ed25519 দিয়ে স্বাক্ষর করে। যে কেউ একটি কপি যাচাই করতে পারেন, কোনো অ্যাকাউন্ট লাগে না।

  1. ডিজাইন: ড্যাশবোর্ডে বা API দিয়ে একটি টেমপ্লেট তৈরি করুন, তারপর একটি ভার্সন প্রকাশ করুন।
  2. পাঠান: একটি খাম পাঠান: টেমপ্লেট id, আপনার ভেরিয়েবল এবং প্রতিটি ভূমিকার জন্য একজন প্রাপকসহ POST /v1/envelopes।
  3. স্বাক্ষর: প্রাপকেরা একটি ইমেইল লিংক পান, অথবা আপনি একটি স্বাক্ষর সেশন তৈরি করে সেটি এমবেড করেন (delivery: "embedded")।
  4. সম্পন্ন: শেষ প্রাপক স্বাক্ষর করলে আপনি প্রতিটি টাইপ করা মানসহ একটি envelope.completed ওয়েবহুক পান।
  5. সিল: envelope.sealed এলে সিল করা PDF (সম্পন্নতার সনদসহ) প্রস্তুত থাকে।
  6. যাচাই: যে কেউ PDF-টি যাচাই পৃষ্ঠায় ছেড়ে দিতে পারেন অথবা পাবলিক যাচাই API কল করতে পারেন।
  • এমন এরর, যা দেখে ব্যবস্থা নেওয়া যায়। প্রতিটি এরর RFC 9457 problem+json; ভ্যালিডেশন এররে প্রতিটি সমস্যার জন্য একটি JSON Pointer থাকে, যেমন /variables/client/email।
  • নিরাপদ রিট্রাই। POST অনুরোধে একটি Idempotency-Key পাঠান, তাহলে রিট্রাই করলে প্রথম রেসপন্সটিই আবার পাওয়া যায়।
  • বিনামূল্যে, সীমাহীন টেস্ট মোড। bf_test_ কী ওয়াটারমার্কযুক্ত খাম তৈরি করে, যার জন্য কখনো বিল হয় না। অথেন্টিকেশন দেখুন।
  • মানদণ্ড মেনে চলা ওয়েবহুক। ডেলিভারিগুলো Standard Webhooks অনুযায়ী স্বাক্ষরিত, তিন দিন পর্যন্ত রিট্রাই করা হয় এবং আবার পাঠানো যায়।
  • OpenAPI 3.1, সরাসরি কোড থেকে তৈরি। রেফারেন্স এবং ডাউনলোডযোগ্য openapi.json / openapi.yaml সেই একই zod কন্ট্র্যাক্ট থেকে তৈরি, যা দিয়ে API ভ্যালিডেশন করে।

API-টি https://api.bonafidesign.com-এ আছে। এই ডকসের সব পাথ এর সাপেক্ষে।