v0.2.3-beta

द्वारा

बुद्धिमत्ता आजाद

लॉगिन पंजीकरण

उत्पाद सामाजिक magazine नया

लॉगिन पंजीकरण

brainful API लाइब्रेरी

नेविगेशन

अवलोकन शुरूआत करना प्रमाणीकरण ब्लॉक बनाएं ब्लॉक में जोड़ें ब्लॉक प्राप्त करें शुरू करें

अवलोकन

The brainful एपीआई enables seamless integration between your applications and brainful's शक्ति content management system. Whether you're building automation tools or integrating with your favorite apps, संगठन RESTFUL API provides a simple and secure way to interact with your content.

फीचर्स

प्रमाणीकरण

Token-based authentication with https encryption

Restful design

Standard http methods with json responses

स्थान

Built-in geolocation capabilities

सूची बनाएं

प्रदर्शन मेट्रिक्स प्राप्त करने में विफल

Use cases

Personal automation

Auto-save notes from your favorite apps
Create location-based content triggers
जोड़ें IFTTT/Zapier user-workflows

एकीकरण

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

सुधार

सूची बनाएं

60 requests per minute per user

शुरूआत करना

Get your api token

Visit your brainful फीचर्स to generate your api token.

Choose your integration method

Select from our example code in cURL, JavaScript, संगठन Python शुरू करें.

Make your first request

Try out the interactive examples below to test your integration.

प्रमाणीकरण

All API requests require your API token in the Authorization header. Get your token from the brainful फीचर्स. The api supports both token and bearer token formats.

आपका ब्रेनफुल कोड:

Authorization: Token YOUR_API_TOKEN

Authorization: Bearer YOUR_API_TOKEN

ब्लॉक बनाएं

POSThttps://brainful.dev/blocks/add

पहुंच का अनुरोध करें

All parameters are sent in the request body as JSON.

Parameter	Type	टेक्स्ट आवश्यक।	विवरण
साझा करना शुरू करें	साझा करना शुरू करें	Yes	जोड़ने के लिए सामग्री (1-5000 अक्षर)
parent_luid	साझा करना शुरू करें	नहीं	luid ब्लॉक खोलें (परिचालनात्मक)
latitude	float	नहीं	latitude (-90° को 90°)
longitude	float	नहीं	longitude (-180° को 180°)
agent	साझा करना शुरू करें	नहीं	Agent identifier (max 50 chars)
team_space	साझा करना शुरू करें	नहीं	Team space slug to add the block to (only for organization members)

त्रुटि-कोई-सामग्री-नहीं:ब्लॉक खोलें luid: latitude (degrees, -90° को 90°): longitude (degrees, -180° को 180°): एजेंट (up to 255 chars):स्पेस:

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: साझा करना शुरू करें

Unique identifier for the created content

slug

Type: साझा करना शुरू करें

URL-friendly version of the content

words

Type: एकीकरण

Number of words in the content

remaining_daily_quota

Type: एकीकरण

Remaining content creation quota for today

Response codes

201बनाया (पहुंच)

400अमान्य अनुरोध बॉडी (अमान्य पंक्ति इंडेक्स)

401Unauthorised (अमान्य अनुरोध बॉडी)

403Forbidden (plan not sufficient)

422Invalid location coordinates

ब्लॉक में जोड़ें

POSThttps://brainful.dev/blocks/append

पहुंच का अनुरोध करें

All parameters are sent in the request body as JSON.

Parameter	Type	टेक्स्ट आवश्यक।	विवरण
identifier	साझा करना शुरू करें	Yes	जिस ब्लॉक में आप जोड़ना चाहते हैं उसका विवरण दें (luid संगठन slug)
साझा करना शुरू करें	साझा करना शुरू करें	Yes	जोड़ने के लिए सामग्री (1-5000 अक्षर)

ब्लॉक हटाया गया (LUID संगठन slug): त्रुटि-कोई-सामग्री-नहीं:

Generated Request

Example response

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

Response fields

luid

Type: साझा करना शुरू करें

Unique identifier for the created content

slug

Type: साझा करना शुरू करें

URL-friendly version of the content

words

Type: एकीकरण

Number of words in the content

remaining_daily_quota

Type: एकीकरण

Remaining content creation quota for today

Response codes

201बनाया (पहुंच)

400अमान्य अनुरोध बॉडी (अमान्य पंक्ति इंडेक्स)

401Unauthorised (अमान्य अनुरोध बॉडी)

403Forbidden (plan not sufficient)

ब्लॉक प्राप्त करें

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

पहुंच का अनुरोध करें

URL Parameters

Parameter	Type	टेक्स्ट आवश्यक।	विवरण
luid	साझा करना शुरू करें	Yes	Unique identifier of the block to retrieve

अमान्य अनुरोध बॉडी

Parameter	Type	टेक्स्ट आवश्यक।	विवरण
latitude	float	नहीं	latitude (-90° को 90°)
longitude	float	नहीं	longitude (-180° को 180°)
agent	साझा करना शुरू करें	नहीं	मैजिक एंटिटीस (मैक्स 50 chars)

ब्लॉक LUID (6 chars): latitude (degrees, -90° को 90°): longitude (degrees, -180° को 180°): एजेंट (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: साझा करना शुरू करें

Username of the content creator

luid

Type: साझा करना शुरू करें

Unique identifier for the block

type

Type: साझा करना शुरू करें

जोड़ने के लिए सामग्री (e.g., "thought")

html

Type: साझा करना शुरू करें

HTML बनाया

created_timestamp

Type: साझा करना शुरू करें

Creation date and time

hits

Type: एकीकरण

Number of views

Response codes

200पहुंच (ब्लॉक नहीं मिला)

401Unauthorised (अमान्य अनुरोध बॉडी)

403Forbidden (plan not sufficient)

404उपयोगकर्ता नहीं मिला (ब्लॉक नहीं मिला)

शुरू करें?

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 here!