v0.2.3-beta

Akili Iliyoachiliwa

ingia jisajili

bidhaa kijamii jarida new

ingia jisajili

brainful maktaba ya API

Uvinjari wa haraka

muhtasari kuanza uthibitisho unda kizuizi ongeza kwenye kizuizi pata kizuizi pata msukumo

muhtasari

-a brainful API inawezesha ujumuishaji usio na mshono kati ya programu zako na brainful's yenye nguvu mfumo wa usimamizi wa maudhui. Iwe unajenga zana za utomatiki au unajumuisha na programu zako unazozipenda, yetu API YA RESTFUL inatoa njia rahisi na salama ya kuingiliana na maudhui yako.

Vipengele muhimu

Uthibitisho salama

Uthibitisho unaotegemea alama na usimbaji wa HTTPS

Muundo wa RESTful

Mbinu za kawaida za HTTP na majibu ya JSON

Msaada wa mahali

Uwezo wa mahali uliojengewa ndani

Kiwango kimedhibitiwa

Imeboreshwa kwa utendaji wa kuaminika

Matumizi

Utomatiki wa kibinafsi

Hifadhi kiotomatiki vidokezo kutoka programu zako unazozipenda
Unda vichochezi vya maudhui vinavyotegemea mahali
Unganisha na IFTTT/Zapier mtiririko wa kazi

Suluhisho za ujumuishaji

Jenga ujumuishaji na vienongezeo vya kawaida
Unda mtiririko wa kazi wa maudhui wa kiotomatiki
Endeleza mifumo ya usimamizi wa maudhui

Mahitaji

Mipaka ya kiwango

60 maombi kwa dakika kwa mtumiaji

Kuanza

Pata alama yako ya API

Tembelea brainful ukurasa wa chaguo kuzalisha alama yako ya API.

Chagua mbinu yako ya ujumuishaji

Chagua kutoka msimbo wetu wa mfano katika cURL, JavaScript, au Python kuanza kwa haraka.

Fanya ombi lako la kwanza

Jaribu mifano ya mwingiliano hapa chini kupima miunganisho wako.

uthibitisho

Maombi yote ya API yanahitaji tokeni yako ya API katika kichwa cha Uidhinishaji. Pata tokeni yako kutoka brainful ukurasa wa chaguo. API inasaidia umbizo za tokeni na tokeni za mbeba.

Tokeni yako ya API:

Authorization: Token YOUR_API_TOKEN

Authorization: Bearer YOUR_API_TOKEN

unda kizuizi

POSThttps://brainful.one/blocks/add

Vigezo vya ombi

Vigezo vyote vinatumwa katika mwili wa ombi kama JSON.

Kigezo	Aina	Inahitajika	Maelezo
herufi	herufi	Ndiyo	Maudhui ya kuongezwa (1-5000 herufi)
parent_luid	herufi	Hapana	luid ya kizuizi cha mzazi (hiari)
latitude	desimali	Hapana	latitudo (-90° hadi 90°)
longitude	desimali	Hapana	longitudo (-180° hadi 180°)
agent	herufi	Hapana	Agent identifier (max 50 chars)
team_space	herufi	Hapana	Team space slug to add the block to (only for organization members)

Maudhui ya herufi:Kizuizi cha mzazi luid: latitudo (digrii, -90° hadi 90°): longitudo (digrii, -180° hadi 180°): wakala (hadi 255 herufi):Slug ya nafasi ya timu:

Generated Request

Mfano wa majibu

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

Sehemu za majibu

luid

Aina: herufi

Kitambulisho cha kipekee cha maudhui yaliyoundwa

slug

Aina: herufi

URL-friendly version of the content

words

Aina: nambari kamili

Number of words in the content

remaining_daily_quota

Aina: nambari kamili

Remaining content creation quota for today

Misimbo ya majibu

201Imeundwa (mafanikio)

400Ombi baya (herufi batili)

401Hauruhusiwi (tokeni batili)

403Forbidden (plan not sufficient)

422Invalid location coordinates

ongeza kwenye kizuizi

POSThttps://brainful.one/blocks/append

Vigezo vya ombi

Vigezo vyote vinatumwa katika mwili wa ombi kama JSON.

Kigezo	Aina	Inahitajika	Maelezo
identifier	herufi	Ndiyo	Kitambulisho cha kizuizi cha kuongezea (luid au slug)
herufi	herufi	Ndiyo	Maudhui ya kuongezwa (1-5000 herufi)

Kitambulisho cha kizuizi (LUID au slug): Maudhui ya herufi:

Generated Request

Mfano wa majibu

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

Sehemu za majibu

luid

Aina: herufi

Kitambulisho cha kipekee cha maudhui yaliyoundwa

slug

Aina: herufi

URL-friendly version of the content

words

Aina: nambari kamili

Number of words in the content

remaining_daily_quota

Aina: nambari kamili

Remaining content creation quota for today

Misimbo ya majibu

201Imeundwa (mafanikio)

400Ombi baya (herufi batili)

401Hauruhusiwi (tokeni batili)

403Forbidden (plan not sufficient)

pata kizuizi

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

Vigezo vya ombi

URL Parameters

Kigezo	Aina	Inahitajika	Maelezo
luid	herufi	Ndiyo	Kitambulisho cha kipekee cha kizuizi cha kurejesha

Mwili wa ombi

Kigezo	Aina	Inahitajika	Maelezo
latitude	desimali	Hapana	latitudo (-90° hadi 90°)
longitude	desimali	Hapana	longitudo (-180° hadi 180°)
agent	herufi	Hapana	Kitambulisho cha wakala (juu kabisa 50 herufi)

kizuizi LUID (6 herufi): latitudo (digrii, -90° hadi 90°): longitudo (digrii, -180° hadi 180°): wakala (hadi 255 herufi):

Generated Request

Mfano wa majibu

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

Sehemu za majibu

creator

Aina: herufi

Username of the content creator

luid

Aina: herufi

Kitambulisho cha kipekee cha kizuizi

type

Aina: herufi

Aina ya maudhui (k.m., "thought")

html

Aina: herufi

HTML maudhui ya kizuizi

created_timestamp

Aina: herufi

Creation date and time

hits

Aina: nambari kamili

Number of views

Misimbo ya majibu

200Mafanikio (kizuizi kimepatikana)

401Hauruhusiwi (tokeni batili)

403Forbidden (plan not sufficient)

404Hakijapatikana (kizuizi hakijapatikana)

Jisikie ameshangilizwa?

Angalia baadhi ya miunganisho yetu rasmi iliyojengwa na brainful User API hapa!