v0.2.3-beta

Inteligența Dezlănțuită

brainful bibliotecă API

Navigare rapidă

prezentare generală începere autentificare creează bloc adăugați la bloc obține bloc inspirați-vă

prezentare generală

The brainful API permite integrarea fără întrerupere între aplicațiile dumneavoastră și brainful's puternic sistem de management conținut. Fie că construiți unelte de automatizare sau integrați cu aplicațiile dumneavoastră preferate, al nostru API RESTFUL oferă o modalitate simplă și sigură de a interacționa cu conținutul dumneavoastră.

Funcționalități cheie

Autentificare sigură

Autentificare bazată pe token cu criptare HTTPS

Design RESTful

Metode HTTP standard cu răspunsuri JSON

Suport locație

Capacități de geolocalizare integrate

Limitată rată

Optimizat pentru performanță fiabilă

Cazuri de utilizare

Automatizare personală

Salvare automată de notițe din aplicațiile dumneavoastră preferate
Creați declansatori de conținut bazati pe locație
Conectați-vă cu IFTTT/Zapier fluxuri de lucru

Soluții de integrare

Construiți integrări și extensii personalizate
Creați fluxuri de conținut automatizate
Dezvoltați sisteme de management conținut

Cerințe

Limite de rată

60 cereri pe minut pe utilizator

Începere

Obțineți token-ul API

Vizitați brainful pagina opțiuni pentru a genera token-ul API.

Alegeți metoda de integrare

Selectați din codul nostru exemplu în cURL, JavaScript, sau Python pentru a începe rapid.

Faceți prima cerere

Încearcați exemplele interactive de mai jos pentru a testa integrarea.

autentificare

toate cererile API necesită token-ul API în antetul Authorization. Obțineți token-ul din brainful pagina opțiuni. API-ul suportă atât formatele token cât și bearer token.

Token-ul dumneavoastră API:

Authorization: Token YOUR_API_TOKEN

Authorization: Bearer YOUR_API_TOKEN

creează bloc

POSThttps://brainful.dev/blocks/add

Parametri cerere

Toți parametrii sunt trimiși în corpul cererii ca JSON.

Parametru	Tip	Necesar	Descriere
string	string	Da	Content to be added (1-5000 caractere)
parent_luid	string	Nu	luid al blocului părinte (opțional)
latitude	float	Nu	latitudine (-90° către 90°)
longitude	float	Nu	longitudine (-180° către 180°)
agent	string	Nu	Agent identifier (max 50 chars)
team_space	string	Nu	Team space slug to add the block to (only for organization members)

Conținut șir:Bloc părinte luid: latitudine (grade, -90° către 90°): longitudine (grade, -180° către 180°): agent (până la 255 caractere):Identificator spațiu echipă:

Generated Request

Răspuns exemplu

{
                    "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
                  }

Câmpurile răspunsului

luid

Tip: string

Identificator unic pentru conținutul creat

slug

Tip: string

URL-friendly version of the content

words

Tip: număr întreg

Number of words in the content

remaining_daily_quota

Tip: număr întreg

Remaining content creation quota for today

Codurile răspunsului

201Creat (succes)

400Cerere greșită (text nevalid)

401Neautorizat (token nevalid)

403Forbidden (plan not sufficient)

422Invalid location coordinates

adăugați la bloc

POSThttps://brainful.dev/blocks/append

Parametri cerere

Toți parametrii sunt trimiși în corpul cererii ca JSON.

Parametru	Tip	Necesar	Descriere
identifier	string	Da	Identificatorul blocului la care să se adauge (luid sau slug)
string	string	Da	Conținutul care urmează să fie adăugat (1-5000 caractere)

Identificatorul blocului (LUID sau slug): Conținut șir:

Generated Request

Răspuns exemplu

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

Câmpurile răspunsului

luid

Tip: string

Identificator unic pentru conținutul creat

slug

Tip: string

URL-friendly version of the content

words

Tip: număr întreg

Number of words in the content

remaining_daily_quota

Tip: număr întreg

Remaining content creation quota for today

Codurile răspunsului

201Creat (succes)

400Cerere greșită (text nevalid)

401Neautorizat (token nevalid)

403Forbidden (plan not sufficient)

obține bloc

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

Parametri cerere

URL Parameters

Parametru	Tip	Necesar	Descriere
luid	string	Da	Identificator unic al blocului de recuperat

Corpul cererii

Parametru	Tip	Necesar	Descriere
latitude	float	Nu	latitudine (-90° către 90°)
longitude	float	Nu	longitudine (-180° către 180°)
agent	string	Nu	Identificator agent (maxim 50 caractere)

bloc LUID (6 caractere): latitudine (grade, -90° către 90°): longitudine (grade, -180° către 180°): agent (până la 255 caractere):

Generated Request

Răspuns exemplu

{
  "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
}

Câmpurile răspunsului

creator

Tip: string

Username of the content creator

luid

Tip: string

Identificator unic pentru bloc

type

Tip: string

Tipul conținutului (de ex., "thought")

html

Tip: string

HTML conținutul blocului

created_timestamp

Tip: string

Creation date and time

hits

Tip: număr întreg

Number of views

Codurile răspunsului

200Succes (bloc găsit)

401Neautorizat (token nevalid)

403Forbidden (plan not sufficient)

404Negăsit (bloc negăsit)

Inspirați-vă?

aruncăți o privire la câteva din integrările noastre oficiale construite cu brainful User API aici!