ورود / ثبت‌نام

مستندات API

شروع سریع

  1. وارد شوید و از صفحه‌ی توکن‌های API یک توکن بسازید.
  2. توکن را در سرآیند Authorization بفرستید.
  3. پاسخ‌ها JSON هستند. محدودیت طرح رایگان: 30/min و ۱٬۰۰۰ درخواست در روز؛ بیش از آن پاسخ 429 می‌گیرید.
curl -H "Authorization: Token kol_..." \
  "https://kolunsec.com/api/v1/cves/?product=exchange%20server&min_cvss=9&kev=true"

نقاط دسترسی

https://kolunsec.com/api/v1/
GET /api/v1/cves/

فهرست CVEها، جدیدترین اول.

q · product · vendor · severity · min_cvss · min_epss · kev · published_after · published_before · sort=latest|cvss|epss · limit · offset

GET /api/v1/cves/{id}/

جزئیات کامل یک CVE: همه‌ی امتیازهای CVSS، محصولات و نسخه‌ها، KEV، تاریخچه‌ی EPSS، منابع و اخبار مرتبط.

GET /api/v1/kev/

ورودی‌های فهرست KEV آژانس CISA، جدیدترین اول.

limit · offset

GET /api/v1/news/

اخبار امنیتی همراه با CVEهای پیوندشده.

source · cve · limit · offset

GET /api/v1/products/

جستجوی محصول؛ همه‌ی نسخه‌های یک محصول در یک خانواده با تعداد CVE و KEV.

q (حداقل ۲ نویسه)

GET /api/v1/subscriptions/

محصولاتی که برای هشدار تلگرامی دنبال می‌کنید.

POST /api/v1/subscriptions/

دنبال کردن یک محصول. بدنه‌ی JSON: product (شناسه از products/)، و اختیاری min_severity و include_news.

DELETE /api/v1/subscriptions/{id}/

لغو دنبال کردن.

صفحه‌بندی

فهرست‌ها با limit (حداکثر ۱۰۰) و offset صفحه‌بندی می‌شوند. برای سرعت، تعداد کل برگردانده نمی‌شود؛ تا وقتی next خالی نیست، صفحه‌ی بعد وجود دارد.

{
  "next": "https://kolunsec.com/api/v1/cves/?limit=25&offset=25",
  "previous": null,
  "results": [
    {
      "id": "CVE-2021-26855",
      "title": "Microsoft Exchange Server Remote Code Execution Vulnerability",
      "cvss_score": "9.8", "cvss_severity": "CRITICAL", "cvss_version": "3.1",
      "epss": 0.9431, "epss_percentile": 0.9995, "in_kev": true,
      "products": ["Microsoft Exchange Server"],
      "url": "https://.../cve/CVE-2021-26855/"
    }
  ]
}

خطاها

401 توکن نامعتبر یا باطل‌شده · 400 پارامتر نادرست · 404 یافت نشد · 429 عبور از محدودیت نرخ (سرآیند Retry-After)

منابع خبری مجاز برای source: bleepingcomputer, darkreading, grahamcluley, helpnetsecurity, infosecurity, krebs, malwarebytes, schneier, securityaffairs, securityweek, thehackernews, theregister, welivesecurity