v0.2.3-beta

Intelligens Släppt Lös

logga in registrera

produkt social magasin new

logga in registrera

brainful API-bibliotek

Snabbnavigering

översikt komma igång autentisering skapa block lägg till i block hämta block bli inspirerad

översikt

Den brainful API möjliggör sömlös integration mellan era applikationer och brainful's kraftfullt innehållshanteringssystem. Oavsett om ni bygger automationsverktyg eller integrerar med era favoritappar, vårt RESTFUL API tillhandahåller ett enkelt och säkert sätt att interagera med ert innehåll.

Nyckelfunktioner

Säker autentisering

Tokenbaserad autentisering med HTTPS-kryptering

RESTful design

Standard HTTP-metoder med JSON-svar

Platsstöd

Inbyggda geolokaliseringsmöjligheter

Hastighetsbegränsad

Optimerad för tillförlitlig prestanda

Användningsfall

Personlig automation

Spara anteckningar automatiskt från era favoritappar
Skapa platsbaserade innehållsutlösare
Anslut till IFTTT/Zapier arbetsflöden

Integrationslösningar

Bygg anpassade integrationer och tillägg
Skapa automatiserade innehållsarbetsflöden
Utveckla innehållshanteringssystem

Krav

Hastighetsbegränsningar

60 förfrågningar per minut per användare

Komma igång

Hämta er API-token

Besök er brainful inställningssida för att generera er API-token.

Välj er integrationsmetod

Välj från vår exempelkod i cURL, JavaScript, eller Python för att komma igång snabbt.

Gör er första förfrågan

Prova de interaktiva exemplen nedan för att testa er integration.

autentisering

Alla API-förfrågningar kräver er API-token i Authorization-headern. Hämta er token från brainful inställningssida. API:et stöder både token- och bearer token-format.

Er API-token:

Authorization: Token YOUR_API_TOKEN

Authorization: Bearer YOUR_API_TOKEN

skapa block

POSThttps://brainful.dev/blocks/add

Förfrågansparametrar

Alla parametrar skickas i förfråganskroppen som JSON.

Parameter	Typ	Obligatorisk	Beskrivning
sträng	sträng	Ja	Innehåll att lägga till (1-5000 tecken)
parent_luid	sträng	Nej	luid av föräldra-blocket (valfritt)
latitude	flyttal	Nej	latitud (-90° till 90°)
longitude	flyttal	Nej	longitud (-180° till 180°)
agent	sträng	Nej	Agent identifier (max 50 chars)
team_space	sträng	Nej	Team space slug to add the block to (only for organization members)

Stränginnehåll:Föräldra-block luid: latitud (grader, -90° till 90°): longitud (grader, -180° till 180°): agent (upp till 255 tecken):Teamutrymmesslug:

Generated Request

Exempelsvar

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

Svarsfält

luid

Typ: sträng

Unik identifierare för det skapade innehållet

slug

Typ: sträng

URL-friendly version of the content

words

Typ: heltal

Number of words in the content

remaining_daily_quota

Typ: heltal

Remaining content creation quota for today

Svarskoder

201Skapad (framgång)

400Felaktig begäran (ogiltig sträng)

401Obehörig (ogiltig token)

403Forbidden (plan not sufficient)

422Invalid location coordinates

lägg till i block

POSThttps://brainful.dev/blocks/append

Förfrågansparametrar

Alla parametrar skickas i förfråganskroppen som JSON.

Parameter	Typ	Obligatorisk	Beskrivning
identifier	sträng	Ja	Identifierare för blocket att lägga till i (luid eller slug)
sträng	sträng	Ja	Innehåll att läggas till (1-5000 tecken)

Blockidentifierare (LUID eller slug): Stränginnehåll:

Generated Request

Exempelsvar

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

Svarsfält

luid

Typ: sträng

Unik identifierare för det skapade innehållet

slug

Typ: sträng

URL-friendly version of the content

words

Typ: heltal

Number of words in the content

remaining_daily_quota

Typ: heltal

Remaining content creation quota for today

Svarskoder

201Skapad (framgång)

400Felaktig begäran (ogiltig sträng)

401Obehörig (ogiltig token)

403Forbidden (plan not sufficient)

hämta block

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

Förfrågansparametrar

URL Parameters

Parameter	Typ	Obligatorisk	Beskrivning
luid	sträng	Ja	Unik identifierare för blocket som ska hämtas

Begäranskropp

Parameter	Typ	Obligatorisk	Beskrivning
latitude	flyttal	Nej	latitud (-90° till 90°)
longitude	flyttal	Nej	longitud (-180° till 180°)
agent	sträng	Nej	Agentidentifierare (max 50 tecken)

block LUID (6 tecken): latitud (grader, -90° till 90°): longitud (grader, -180° till 180°): agent (upp till 255 tecken):

Generated Request

Exempelsvar

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

Svarsfält

creator

Typ: sträng

Username of the content creator

luid

Typ: sträng

Unik identifierare för blocket

type

Typ: sträng

Innehållstyp (t.ex., "thought")

html

Typ: sträng

HTML innehållet i blocket

created_timestamp

Typ: sträng

Creation date and time

hits

Typ: heltal

Number of views

Svarskoder

200Framgång (block hittades)

401Obehörig (ogiltig token)

403Forbidden (plan not sufficient)

404Hittades inte (block hittades inte)

Känn er inspirerade?

Ta en titt på några av våra officiella integrationer byggda med brainful User API här!