Szybki start API

Ten przewodnik przeprowadzi Cię od zera do pierwszego udanego zapytania: utwórz token personalny, poznaj adres bazowy i wywołaj endpoint REST.

Krok 1. Utwórz token personalny

Otwórz panel użytkownika, sekcję tokenów personalnych, i utwórz nowy token (PAT). Skopiuj jego wartość od razu — jest wyświetlana tylko raz i zaczyna się od prefiksu mbp_. Podczas tworzenia wybierz zakresy dostępu (scopes) wystarczające do Twojego zadania; szczegóły w przewodniku po autoryzacji.

Krok 2. Adres bazowy i format

Wszystkie endpointy REST działają pod prefiksem /api. Brak wersjonowania w ścieżce. Ciała żądań i odpowiedzi są w formacie JSON; dla żądań z ciałem przekazuj nagłówek Content-Type: application/json. Token przekazywany jest nagłówkiem Authorization: Bearer mbp_….

Krok 3. Pierwsze zapytanie — lista botów

Sprawdź token zapytaniem o listę Twoich botów. Do tego potrzebny jest zakres bots:read (lub *):

curl -H "Authorization: Bearer mbp_TWÓJ_TOKEN" https://twoja-domena/api/bots

W odpowiedzi otrzymasz tablicę JSON z botami. Jeśli token jest nieprawidłowy lub wygasł — zostanie zwrócone 401 z treścią {"error":"..."} (zob. błędy).

Krok 4. Pierwsza mutacja — utwórz reakcję

Utworzenie reakcji wymaga zakresu reactions:write. Podstaw identyfikator bota z kroku 3:

curl -X POST -H "Authorization: Bearer mbp_TWÓJ_TOKEN" -H "Content-Type: application/json" -d '{"name":"Cześć","trigger":{"type":"command","value":"/start"}}' https://twoja-domena/api/bots/BOT_ID/reactions

Udana odpowiedź zwróci utworzoną reakcję z jej id. Dokładne pola ciała znajdziesz w interaktywnej dokumentacji — generuje ona gotowe przykłady na curl, JavaScript i Python dla każdego endpointu.

Krok 5. Dalej — według dokumentacji

Gdy token działa, resztę wygodniej eksplorować w interaktywnej dokumentacji: widać tam pełną listę endpointów, wymagane zakresy, schematy ciał i przycisk „Try it".

Co dalej