v0.2.3-beta
로그인 가입

brainful API 라이브러리

개요

그 brainful API 귀하의 애플리케이션과 다음 간의 원활한 통합을 가능하게 합니다 brainful's 강력한 콘텐츠 관리 시스템. 자동화 도구를 구축하거나 좋아하는 앱과 통합하는 경우든, 저희의 RESTFUL API 콘텐츠와 상호작용하는 간단하고 안전한 방법을 제공합니다.

주요 기능

보안 인증

HTTPS 암호화를 통한 토큰 기반 인증

RESTful 디자인

JSON 응답을 사용한 표준 HTTP 메소드

위치 지원

내장 위치 추적 기능

속도 제한

안정적인 성능을 위해 최적화됨

사용 사례

개인 자동화

  • 좋아하는 앱에서 노트 자동 저장
  • 위치 기반 콘텐츠 트리거 생성
  • 다음과 연결 IFTTT/Zapier 워크플로우

통합 솔루션

  • 맞춤 통합 및 확장 프로그램 구축
  • 자동화된 콘텐츠 워크플로우 생성
  • 개발 콘텐츠 관리 시스템

요구사항

속도 제한

60 사용자당 분당 요청 수

시작하기

1

API 토큰 받기

귀하의 다음을 방문하세요 brainful 옵션 페이지 API 토큰을 생성하려면.

2

통합 방법을 선택하세요

다음에서 예제 코드를 선택하세요 cURL, JavaScript, 또는 Python 빠르게 시작하려면.

3

첫 번째 요청 하기

아래의 대화형 예제를 사용하여 통합을 테스트해 보세요.

인증

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

요청 매개변수

모든 매개변수는 요청 본문에 다음과 같이 전송됩니다 JSON.

매개변수유형필수설명
문자열문자열추가할 콘텐츠 (1-5000 문자)
parent_luid문자열아니오luid 상위 블록의 (선택사항)
latitude실수아니오위도 (-90° 에서 90°)
longitude실수아니오경도 (-180° 에서 180°)
agent문자열아니오Agent identifier (max 50 chars)
team_space문자열아니오Team space slug to add the block to (only for organization members)

Generated Request

예시 응답

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

응답 필드

luid

유형: 문자열

생성된 콘텐츠의 고유 식별자

slug

유형: 문자열

URL-friendly version of the content

words

유형: 정수

Number of words in the content

remaining_daily_quota

유형: 정수

Remaining content creation quota for today

응답 코드

201생성됨 (성공)
400잘못된 요청 (잘못된 문자열)
401미인증 (잘못된 토큰)
403Forbidden (plan not sufficient)
422Invalid location coordinates

블록에 추가

POSThttps://brainful.dev/blocks/append

요청 매개변수

모든 매개변수는 요청 본문에 다음과 같이 전송됩니다 JSON.

매개변수유형필수설명
identifier문자열 추가할 블록의 식별자 (luid 또는 slug)
문자열문자열추가할 콘텐츠 (1-5000 문자)

Generated Request

예시 응답

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

응답 필드

luid

유형: 문자열

생성된 콘텐츠의 고유 식별자

slug

유형: 문자열

URL-friendly version of the content

words

유형: 정수

Number of words in the content

remaining_daily_quota

유형: 정수

Remaining content creation quota for today

응답 코드

201생성됨 (성공)
400잘못된 요청 (잘못된 문자열)
401미인증 (잘못된 토큰)
403Forbidden (plan not sufficient)

블록 가져오기

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

요청 매개변수

URL Parameters

매개변수유형필수설명
luid문자열가져올 블록의 고유 식별자

요청 본문

매개변수유형필수설명
latitude실수아니오위도 (-90° 에서 90°)
longitude실수아니오경도 (-180° 에서 180°)
agent문자열아니오 에이전트 식별자 (최대 50 문자)

Generated Request

예시 응답

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

응답 필드

creator

유형: 문자열

Username of the content creator

luid

유형: 문자열

블록의 고유 식별자

type

유형: 문자열

콘텐츠 유형 (예:, "thought")

html

유형: 문자열

HTML 블록의 내용

created_timestamp

유형: 문자열

Creation date and time

hits

유형: 정수

Number of views

응답 코드

200성공 (블록 발견)
401미인증 (잘못된 토큰)
403Forbidden (plan not sufficient)
404찾을 수 없음 (블록을 찾을 수 없음)

영감을 느껴보세요?

brainful User API로 구축된 저희의 공식 통합 사례들을 살펴보세요 여기!