Dla deweloperów

Buduj boty, integracje i osadzenia na publicznym API LookCam. Poniżej znajdziesz podstawy, a pełny kontrakt opisuje specyfikacja OpenAPI.

Specyfikacja OpenAPI

Pełny opis endpointów, modeli i odpowiedzi: pobierz lookcam.openapi.yaml. Zaimportuj ją do Postmana, Insomnii, Scalara lub wygeneruj klienta (np. openapi-typescript, oapi-codegen). Historię zmian API znajdziesz w changelogu API.

Bazowy adres i wersjonowanie

Wszystkie endpointy są pod https://api.lookcam.com/v1.

Uwierzytelnianie

Token osobisty (PAT) — najprostszy dla botów/serwerów. Wygeneruj w Ustawienia → Deweloper i wysyłaj nagłówek Authorization: Bearer <token>. Zakresy: chat:read, chat:send.
Cookie (web) — sesja przeglądarkowa (HttpOnly), używana przez aplikację webową.

Limity (rate limiting)

Endpointy są limitowane per klucz/IP. Po przekroczeniu otrzymasz 429 z nagłówkiem Retry-After — odczekaj i ponów. Projektuj integracje z wykładniczym backoffem.

Boty czatu

Z tokenem o zakresie chat:send/chat:read użyj POST /v1/bot/messages oraz GET /v1/bot/messages (szczegóły w specyfikacji).

SDK i przykłady

Wygeneruj typowanego klienta wprost ze specyfikacji OpenAPI (zalecane), np. dla TypeScript:

npx openapi-typescript https://lookcam.com/openapi/lookcam.openapi.yaml -o lookcam.d.ts

Przykład: prosty bot czatu na osobistym tokenie (PAT, scope chat:send):

const API = 'https://api.lookcam.com/v1'
const TOKEN = process.env.LOOKCAM_TOKEN // PAT z Ustawienia → Deweloper

await fetch(API + '/bot/messages', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ channel: 'twoj_kanal', message: 'Cześć z bota!' }),
})

Webhooki

Subskrypcje zdarzeń (stream.started/ended, follow, subskrypcja, chat) z podpisem HMAC i retry — w przygotowaniu. Wróć tu wkrótce.

Osadzanie (embed)

Odtwarzacz i czat na żywo wstawisz przez iframe — zobacz dokumentację osadzania + generator kodu.

Korzystając z API akceptujesz zasady dopuszczalnego użytku.