v0.2.3-beta

oleh

Intelligence Unleashed

brainful perpustakaan API

Navigasi cepat

gambaran umum memulai autentikasi buat blok tambahkan ke blok dapatkan blok dapatkan inspirasi

gambaran umum

Yang brainful API memungkinkan integrasi yang mulus antara aplikasi Anda dan brainful's kuat sistem manajemen konten. Apakah Anda sedang membangun alat otomatisasi atau mengintegrasikan dengan aplikasi favorit Anda, kami API RESTFUL menyediakan cara yang sederhana dan aman untuk berinteraksi dengan konten Anda.

Fitur utama

Autentikasi aman

Autentikasi berbasis token dengan enkripsi HTTPS

Desain RESTful

Metode HTTP standar dengan respons JSON

Dukungan lokasi

Kemampuan geolokasi bawaan

Dibatasi tingkat

Dioptimalkan untuk kinerja yang andal

Kasus penggunaan

Otomatisasi pribadi

Simpan otomatis catatan dari aplikasi favorit Anda
Buat pemicu konten berbasis lokasi
Connect with IFTTT/Zapier workflows

Integration solutions

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

Requirements

Rate limits

60 requests per minute per user

Memulai

Get your api token

Visit your brainful options page to generate your api token.

Choose your integration method

Select from our example code in cURL, JavaScript, atau Python to get started quickly.

Make your first request

Try out the interactive examples below to test your integration.

autentikasi

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

Your api token:

Authorization: Token YOUR_API_TOKEN

Authorization: Bearer YOUR_API_TOKEN

buat blok

POSThttps://brainful.dev/blocks/add

Request parameters

All parameters are sent in the request body as JSON.

Parameter	Type	Required	Deskripsi
string	string	Ya	Content to be added (1-5000 karakter)
parent_luid	string	Tidak	luid of the parent block (optional)
latitude	float	Tidak	latitude (-90° ke 90°)
longitude	float	Tidak	longitude (-180° ke 180°)
agent	string	Tidak	Agent identifier (max 50 chars)
team_space	string	Tidak	Team space slug to add the block to (only for organization members)

String content:Parent block luid: latitude (degrees, -90° ke 90°): longitude (degrees, -180° ke 180°): agen (up to 255 chars):Team space 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: integer

Number of words in the content

remaining_daily_quota

Type: integer

Remaining content creation quota for today

Response codes

201Dibuat (success)

400Bad request (invalid string)

401Unauthorised (invalid token)

403Forbidden (plan not sufficient)

422Invalid location coordinates

tambahkan ke blok

POSThttps://brainful.dev/blocks/append

Request parameters

All parameters are sent in the request body as JSON.

Parameter	Type	Required	Deskripsi
identifier	string	Ya	Identifier of the block to append to (luid atau slug)
string	string	Ya	Content to be appended (1-5000 karakter)

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: integer

Number of words in the content

remaining_daily_quota

Type: integer

Remaining content creation quota for today

Response codes

201Dibuat (success)

400Bad request (invalid string)

401Unauthorised (invalid token)

403Forbidden (plan not sufficient)

dapatkan blok

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

Request parameters

URL Parameters

Parameter	Type	Required	Deskripsi
luid	string	Ya	Unique identifier of the block to retrieve

Request body

Parameter	Type	Required	Deskripsi
latitude	float	Tidak	latitude (-90° ke 90°)
longitude	float	Tidak	longitude (-180° ke 180°)
agent	string	Tidak	Agent identifier (maks 50 chars)

blok LUID (6 chars): latitude (degrees, -90° ke 90°): longitude (degrees, -180° ke 180°): agen (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

Jenis isi (e.g., "thought")

html

Type: string

HTML content of the block

created_timestamp

Type: string

Creation date and time

hits

Type: integer

Number of views

Response codes

200Success (block found)

401Unauthorised (invalid token)

403Forbidden (plan not sufficient)

404Not found (block not found)

Feel inspired?

Take a look at some of our official integrations built with brainful User APITake a look at some of our official integrations built with brainful User API di sini!