পাবলিক যাচাইকরণ

এই এন্ডপয়েন্টগুলি পাবলিক এবং প্রমাণীকরণের প্রয়োজন হয় না। তারা যেকেউকে ব্যাজ ক্রেডেনশিয়াল যাচাই করতে এবং Open Badge v2.0 JSON ডেটা পুনরুদ্ধার করতে দেয়।

সমস্ত এন্ডপয়েন্ট https://api.badges.ninja এর সাপেক্ষে।

ইস্যুয়ার পান

একটি প্রদত্ত ইস্যুয়ারের জন্য Open Badge v2.0 ইস্যুয়ার প্রোফাইল JSON পুনরুদ্ধার করুন।

GET /certify-badge/issuer/{guid}

উদাহরণ

curl https://api.badges.ninja/certify-badge/issuer/a1b2c3d4-e5f6-7890-abcd-ef1234567890

প্রতিক্রিয়া

{
  "@context": "https://w3id.org/openbadges/v2",
  "type": "Issuer",
  "id": "https://api.badges.ninja/certify-badge/issuer/a1b2c3d4-...",
  "name": "Acme Academy",
  "url": "https://acme.example.com",
  "email": "badges@acme.example.com",
  "verification": {
    "type": "hosted",
    "allowedOrigins": "api.badges.ninja"
  }
}

---

ব্যাজ পান

একটি প্রদত্ত ব্যাজের জন্য Open Badge v2.0 BadgeClass JSON পুনরুদ্ধার করুন।

GET /certify-badge/badge/{guid}

উদাহরণ

curl https://api.badges.ninja/certify-badge/badge/b1c2d3e4-f5a6-7890-bcde-f12345678901

প্রতিক্রিয়া

{
  "@context": "https://w3id.org/openbadges/v2",
  "type": "BadgeClass",
  "id": "https://api.badges.ninja/certify-badge/badge/b1c2d3e4-...",
  "name": "JavaScript Fundamentals",
  "description": "Demonstrates proficiency in core JavaScript concepts",
  "criteria": {
    "narrative": "Completed the JavaScript Fundamentals course with a score of 80% or higher"
  },
  "image": "https://ipfs.ninja/ipfs/Qm...",
  "issuer": "https://api.badges.ninja/certify-badge/issuer/a1b2c3d4-..."
}

---

সনদ পান

একটি প্রদত্ত সনদের জন্য Open Badge v2.0 অ্যাসার্শন JSON পুনরুদ্ধার করুন।

GET /certify-badge/award/{guid}

উদাহরণ

curl https://api.badges.ninja/certify-badge/award/c1d2e3f4-a5b6-7890-cdef-123456789012

প্রতিক্রিয়া

{
  "@context": "https://w3id.org/openbadges/v2",
  "type": "Assertion",
  "id": "https://api.badges.ninja/certify-badge/award/c1d2e3f4-...",
  "recipient": {
    "type": "email",
    "hashed": true,
    "identity": "sha256$..."
  },
  "badge": "https://api.badges.ninja/certify-badge/badge/b1c2d3e4-...",
  "issuedOn": "2025-01-15T00:00:00.000Z",
  "verification": {
    "type": "hosted"
  }
}

নোট

• প্রাপকের ইমেল Open Badge স্পেক অনুসরণ করে গোপনীয়তার জন্য হ্যাশ (SHA-256) করা হয়।
• প্রতিক্রিয়া 1 ঘন্টার জন্য ক্যাশ করা হয় (Cache-Control: public, max-age=3600)।

---

সনদ শেয়ার টেক্সট পান

একটি সনদের ব্যাজের জন্য কাস্টম শেয়ার টেক্সট পুনরুদ্ধার করুন।

GET /certify-badge/award/{guid}/share-text

উদাহরণ

curl https://api.badges.ninja/certify-badge/award/c1d2e3f4-a5b6-7890-cdef-123456789012/share-text

প্রতিক্রিয়া

{
  "text": "I just earned the JavaScript Fundamentals badge! Check it out:"
}

যদি কোনো কাস্টম শেয়ার টেক্সট সেট না থাকে, একটি ডিফল্ট বার্তা ফেরত দেওয়া হয়।

---

সনদ ইমেল পাঠান (পাবলিক)

পাবলিক এন্ডপয়েন্ট থেকে একটি সনদ বিজ্ঞপ্তি ইমেল পাঠান। এটি পাবলিক শেয়ার পৃষ্ঠা দ্বারা ব্যবহৃত হয়।

POST /certify-badge/award/{guid}/send-email

প্যারামিটার

প্যারামিটার	প্রকার	প্রয়োজনীয়	বিবরণ
recipients	string	হ্যাঁ	ইমেল ঠিকানার কমা-বিভক্ত তালিকা
subject	string	না	ইমেল বিষয়
message	string	না	ইমেলে অন্তর্ভুক্ত করার জন্য কাস্টম বার্তা

উদাহরণ

curl -X POST https://api.badges.ninja/certify-badge/award/c1d2e3f4-a5b6-7890-cdef-123456789012/send-email \
  -H "Content-Type: application/json" \
  -d '{
    "parameters": {
      "recipients": "colleague@example.com",
      "message": "Check out this badge!"
    }
  }'

প্রতিক্রিয়া

{
  "statusCode": 200,
  "info": "award sent"
}

---

ইস্যুয়ার যাচাই

ইস্যুয়ার ইমেলে পাঠানো যাচাইকরণ লিঙ্কে ক্লিক করে একটি ইস্যুয়ার যাচাই করুন। এটি সাধারণত যাচাইকরণ ইমেলের লিঙ্কের মাধ্যমে অ্যাক্সেস করা হয়, সরাসরি কল করা হয় না।

GET /certify-badge/verify-issuer/{guid}/{code}

প্যারামিটার

প্যারামিটার	প্রকার	বিবরণ
guid	string	ইস্যুয়ার GUID
code	string	যাচাইকরণ কোড

প্রতিক্রিয়া

যাচাইকরণ সফল বা ব্যর্থ হয়েছে তা নিশ্চিত করে একটি HTML পৃষ্ঠা ফেরত দেয়। এই এন্ডপয়েন্টটি একটি ব্রাউজারে খোলার জন্য ডিজাইন করা হয়েছে।