v0.2.3-beta

przez

Uwolniona Inteligencja

zaloguj się zarejestruj się

product społecznościowy magazyn nowy

zaloguj się zarejestruj się

brainful biblioteka API

Quick navigation

overview rozpoczęcie uwierzytelnianie stwórz blok dołącz do bloku pobierz blok zainspiruj się

overview

Ten brainful API umożliwia płynną integrację między Pańskimi aplikacjami a brainful's potężnym systemem zarządzania treścią. Czy budujesz narzędzia automatyzacji, czy integrujesz się z ulubionymi aplikacjami, nasze RESTFUL API zapewnia prostą i bezpieczną metodę interakcji z Pańską treścią.

Kluczowe funkcje

Bezpieczne uwierzytelnianie

Uwierzytelnianie oparte na tokenach z szyfrowaniem https

Projekt restful

Standardowe metody http z odpowiedziami json

Obsługa lokalizacji

Wbudowane możliwości geolokalizacji

Ograniczone limitami

Zoptymalizowane dla niezawodnej wydajności

Przypadki użycia

Osobista automatyzacja

Automatyczne zapisywanie notatek z ulubionych aplikacji
Twórz wyzwalacze treści oparte na lokalizacji
Połącz z IFTTT/Zapier przepaływy pracy

Rozwiązania integracyjne

Buduj niestandardowe integracje i rozszerzenia
Twórz zautomatyzowane przepływy treści
Rozwijaj systemy zarządzania treścią

Wymagania

Limity zapytań

60 zapytań na minutę na użytkownika

Rozpoczęcie

Pobierz swój token API

Odwiedź swoją brainful stronę opcji aby wygenerować swój token API.

Wybierz metodę integracji

Wybierz z naszego przykładowego kodu w cURL, JavaScript, lub Python aby szybko rozpocząć.

Złóż pierwsze zapytanie

Wypróbuj interaktywne przykłady poniżej, aby przetestować integrację.

uwierzytelnianie

Wszystkie zapytania API wymagają Pańskiego tokena API w nagłówku Authorization. Pobierz swój token ze brainful stronę opcji. API obsługuje zarówno formaty token jak i bearer token.

Pański token API:

Authorization: Token YOUR_API_TOKEN

Authorization: Bearer YOUR_API_TOKEN

stwórz blok

POSThttps://brainful.dev/blocks/add

Parametry zapytania

Wszystkie parametry są wysyłane w treści zapytania jako JSON.

Parametr	Typ	Wymagane	Opis
ciąg znaków	ciąg znaków	Tak	Treść do dodania (1-5000 znaki)
parent_luid	ciąg znaków	Nie	luid bloku nadrzędnego (opcjonalne)
latitude	liczba zmiennoprzecinkowa	Nie	szerokość geograficzna (-90° do 90°)
longitude	liczba zmiennoprzecinkowa	Nie	długość geograficzna (-180° do 180°)
agent	ciąg znaków	Nie	Agent identifier (max 50 chars)
team_space	ciąg znaków	Nie	Team space slug to add the block to (only for organization members)

Treść tekstowa:Blok nadrzędny luid: szerokość geograficzna (stopnie, -90° do 90°): długość geograficzna (stopnie, -180° do 180°): agent (do 255 znaków):Slug przestrzeni zespołowej:

Generated Request

Przykładowa odpowiedź

{
                    "luid": "abc123",
                    "slug": "My New Block",
                    "type": "thought",
                    "pinned": false,
                    "entities": [],
                    "created_timestamp": "2024-01-01T00:00:00Z",
                    "last_edited": "2024-01-01T00:00:00Z",
                    "experience": 5,
                    "remaining_daily_quota": 97
                  }

Pola odpowiedzi

luid

Typ: ciąg znaków

Unikalny identyfikator dla utworzonej treści

slug

Typ: ciąg znaków

URL-friendly version of the content

words

Typ: liczba całkowita

Number of words in the content

remaining_daily_quota

Typ: liczba całkowita

Remaining content creation quota for today

Kody odpowiedzi

201Utworzony (sukces)

400Nieprawidłowe zapytanie (nieprawidłowy ciąg znaków)

401Nieautoryzowany (nieprawidłowy token)

403Forbidden (plan not sufficient)

422Invalid location coordinates

dołącz do bloku

POSThttps://brainful.dev/blocks/append

Parametry zapytania

Wszystkie parametry są wysyłane w treści zapytania jako JSON.

Parametr	Typ	Wymagane	Opis
identifier	ciąg znaków	Tak	Identyfikator bloku do dołączenia (luid lub slug)
ciąg znaków	ciąg znaków	Tak	Treść do dołączenia (1-5000 znaki)

Identyfikator bloku (LUID lub slug): Treść tekstowa:

Generated Request

Przykładowa odpowiedź

{
  "details": "Text appended to block successfully.",
  "luid": "abc123",
  "slug": "my-example-block"
}

Pola odpowiedzi

luid

Typ: ciąg znaków

Unikalny identyfikator dla utworzonej treści

slug

Typ: ciąg znaków

URL-friendly version of the content

words

Typ: liczba całkowita

Number of words in the content

remaining_daily_quota

Typ: liczba całkowita

Remaining content creation quota for today

Kody odpowiedzi

201Utworzony (sukces)

400Nieprawidłowe zapytanie (nieprawidłowy ciąg znaków)

401Nieautoryzowany (nieprawidłowy token)

403Forbidden (plan not sufficient)

pobierz blok

GEThttps://brainful.dev/blocks/get/{luid}

Parametry zapytania

URL Parameters

Parametr	Typ	Wymagane	Opis
luid	ciąg znaków	Tak	Unikalny identyfikator bloku do pobrania

Treść zapytania

Parametr	Typ	Wymagane	Opis
latitude	liczba zmiennoprzecinkowa	Nie	szerokość geograficzna (-90° do 90°)
longitude	liczba zmiennoprzecinkowa	Nie	długość geograficzna (-180° do 180°)
agent	ciąg znaków	Nie	Identyfikator agenta (maksymalny 50 znaków)

blok LUID (6 znaków): szerokość geograficzna (stopnie, -90° do 90°): długość geograficzna (stopnie, -180° do 180°): agent (do 255 znaków):

Generated Request

Przykładowa odpowiedź

{
  "creator": "johnnyappleseed",
  "luid": "abc123",
  "slug": "My New Block",
  "type": "thought",
  "html": "My New Block",
  "blocks": [],
  "entities": [],
  "flagged": false,
  "pinned": false,
  "archived": false,
  "trashed": false,
  "public": false,
  "created_timestamp": "2025-01-28 18:01",
  "last_edited": "2025-01-28 18:01",
  "words": 3,
  "bytes": 45,
  "hits": 0
}

Pola odpowiedzi

creator

Typ: ciąg znaków

Username of the content creator

luid

Typ: ciąg znaków

Unikalny identyfikator dla bloku

type

Typ: ciąg znaków

Typ treści (np., "thought")

html

Typ: ciąg znaków

HTML treść bloku

created_timestamp

Typ: ciąg znaków

Creation date and time

hits

Typ: liczba całkowita

Number of views

Kody odpowiedzi

200Sukces (blok znaleziony)

401Nieautoryzowany (nieprawidłowy token)

403Forbidden (plan not sufficient)

404Nie znaleziono (blok nie znaleziony)

Poczuj inspirację?

Sprawdź niektóre z naszych oficjalnych integracji zbudowanych z brainful User API tutaj!