v0.3.7-beta

von

Intelligence Unleashed

Anmelden Registrieren

Produkt community magazine Aktualisierungen

Anmelden Registrieren

brainful API-Bibliothek

Schnelle Navigation

Übersicht Erste Schritte Authentifizierung Block erstellen an Block anhängen Block abrufen lassen Sie sich inspirieren

Übersicht

Die brainful API enables seamless integration between your applications and brainful's leistungsstark content management system. Whether you're building automation tools or integrating with your favorite apps, unsere RESTFUL API provides a simple and secure way to interact with your content.

Hauptmerkmale

Sichere Authentifizierung

Token-based authentication with https encryption

Restful design

Standard http methods with json responses

Standortunterstützung

Built-in geolocation capabilities

Ratenbegrenzt

Optimised for reliable performance

Use cases

Personal automation

Auto-save notes from your favorite apps
Create location-based content triggers
Verbinden mit IFTTT/Zapier Arbeitsabläufe

Integrationslösungen

Build custom integrations and extensions
Create automated content workflows
Develop content management systems

Anforderungen

Ratenbegrenzungen

60 requests per minute per user

Erste Schritte

Get your api token

Visit your brainful Optionsseite to generate your api token.

Choose your integration method

Select from our example code in cURL, JavaScript, oder Python um schnell zu beginnen.

Make your first request

Try out the interactive examples below to test your integration.

Authentifizierung

All API requests require your API token in the Authorization header. Get your token from the brainful Optionsseite. The api supports both token and bearer token formats.

Ihr API-Token:

Authorization: Token YOUR_API_TOKEN

Authorization: Bearer YOUR_API_TOKEN

Block erstellen

POSThttps://brainful.one/blocks/add

Anfrageparameter

All parameters are sent in the request body as JSON.

Parameter	Type	Erforderlich	Beschreibung
string	string	Ja	Hinzuzufügender Inhalt (1-5000 Zeichen)
parent_luid	string	Nein	luid des übergeordneten Blocks (optional)
latitude	float	Nein	latitude (-90° zu 90°)
longitude	float	Nein	longitude (-180° zu 180°)
agent	string	Nein	Agent identifier (max 50 chars)
team_space	string	Nein	Team space slug to add the block to (only for organization members)

Zeichenketteninhalt:Übergeordneter Block luid: latitude (degrees, -90° zu 90°): longitude (degrees, -180° zu 180°): Agent (up to 255 chars):Team-Bereichs-Slug:

Generated Request

Example response

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

Response fields

luid

Type: string

Unique identifier for the created content

slug

Type: string

URL-friendly version of the content

words

Type: Ganzzahl

Number of words in the content

remaining_daily_quota

Type: Ganzzahl

Remaining content creation quota for today

Response codes

201Erstellt (Erfolg)

400Bad request (ungültige Zeichenkette)

401Unauthorised (ungültiges Token)

403Forbidden (plan not sufficient)

422Invalid location coordinates

an Block anhängen

POSThttps://brainful.one/blocks/append

Anfrageparameter

All parameters are sent in the request body as JSON.

Parameter	Type	Erforderlich	Beschreibung
identifier	string	Ja	Bezeichner des Blocks, an den angehängt werden soll (luid oder slug)
string	string	Ja	Anzuhängender Inhalt (1-5000 Zeichen)

Block-Bezeichner (LUID oder slug): Zeichenketteninhalt:

Generated Request

Example response

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

Response fields

luid

Type: string

Unique identifier for the created content

slug

Type: string

URL-friendly version of the content

words

Type: Ganzzahl

Number of words in the content

remaining_daily_quota

Type: Ganzzahl

Remaining content creation quota for today

Response codes

201Erstellt (Erfolg)

400Bad request (ungültige Zeichenkette)

401Unauthorised (ungültiges Token)

403Forbidden (plan not sufficient)

Block abrufen

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

Anfrageparameter

URL Parameters

Parameter	Type	Erforderlich	Beschreibung
luid	string	Ja	Unique identifier of the block to retrieve

Anfragekörper

Parameter	Type	Erforderlich	Beschreibung
latitude	float	Nein	latitude (-90° zu 90°)
longitude	float	Nein	longitude (-180° zu 180°)
agent	string	Nein	Agent-Bezeichner (max 50 chars)

Block LUID (6 chars): latitude (degrees, -90° zu 90°): longitude (degrees, -180° zu 180°): Agent (up to 255 chars):

Generated Request

Example response

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

Response fields

creator

Type: string

Username of the content creator

luid

Type: string

Unique identifier for the block

type

Type: string

Inhaltstyp (e.g., "thought")

html

Type: string

HTML Inhalt des Blocks

created_timestamp

Type: string

Creation date and time

hits

Type: Ganzzahl

Number of views

Response codes

200Erfolg (Block gefunden)

401Unauthorised (ungültiges Token)

403Forbidden (plan not sufficient)

404Nicht gefunden (Block nicht gefunden)

Lassen Sie sich inspirieren?

Take a look at some of our official integrations built with brainful User API here!