API для компаній

Як отримати ключ

Напишіть на support@nebosvid.com:

• компанія чи проєкт і сайт;
• для чого дані і де їх побачать люди;
• які доступи потрібні (нижче);
• скільки запитів за хвилину й за добу, скільки потоків одночасно.

Ключ надсилаємо листом. Зберігайте його як пароль: ми зберігаємо лише його відбиток, тож показати вдруге чи відновити не можемо — лише видати новий. Загубили чи він потрапив до чужих — напишіть, ми відкличемо його одразу.

Доступи

• live — загрози й тривоги зараз: /threats, /alerts, /kinds, /status, /channels.
• stream — потік наживо (WebSocket /stream): кадр щоразу, як змінились загрози чи тривоги.
• posts — тексти постів каналів (/posts і пости в потоці), лише публічних каналів з нашого списку.
• history — історія й статистика ночей: /history, /stats.

Даних людей (пристрої, сімʼї, сповіщення) ключ компанії не дає ніколи.

Як звертатись

Адреса: https://nebosvid.com/api/v1. Ключ — у заголовку Authorization: Bearer <ключ>:

curl -H "Authorization: Bearer nbs_…" https://nebosvid.com/api/v1/threats

Потоку браузер заголовок не передає, тому ключ можна дати в адресі: wss://nebosvid.com/api/v1/stream?key=nbs_….

Повний опис запитів і відповідей — специфікація OpenAPI: /api/v1/openapi.yaml.

Ліміти й помилки

• Звичайно: 60 запитів за хвилину, 20 000 за добу (доба — за київським часом), 2 потоки одночасно. Потрібно більше — напишіть, змінимо без нового ключа.
• 429 — ліміт вичерпано; заголовок Retry-After каже, через скільки секунд можна знову.
• 403 — цей ключ не дає такого доступу.
• 401 key_revoked — ключ відкликано.

Умови

• Небосвід — агрегатор відкритих джерел, не офіційна система оповіщення. Не подавайте ці дані як офіційні; тривоги — з офіційного джерела, загрози — з публічних каналів моніторингу і можуть запізнюватись чи помилятись.
• Вказуйте джерело: «Небосвід, nebosvid.com».
• Ключ — лише для вашого сервісу: не публікуйте його і не передавайте іншим. За зловживання ключ відкликаємо.