개발자
구축하세요,Mateflow API 위에서.
Mateflow 오픈 API 위에 구축하세요 — 범위 지정 API 키, JSON POST 엔드포인트, Webhook으로 커뮤니티를 스택과 연동합니다.
기능
통합에 필요한 모든 것
API key 인증
커뮤니티 관리 콘솔에서 범위가 지정된 API 키를 생성하세요. 모든 요청은 X-API-Key 헤더로 인증됩니다.
REST API
일관된 JSON API로 커뮤니티 데이터를 읽고 씁니다. 모든 엔드포인트는 /site_open_api/v1 아래에 있으며 POST 메서드와 JSON 본문을 사용합니다.
Webhooks
webhook 엔드포인트를 구성하여 멤버 가입, 결제, 콘텐츠 변경 등의 이벤트 알림을 실시간으로 수신하세요.
통합
통합 허브를 통해 서드파티 도구를 연결하세요. 일반적인 워크플로를 기본 지원하며, 기능 확장을 위한 앱 카탈로그를 제공합니다.
SSO (SAML 및 OIDC)
SAML 2.0 및 OpenID Connect 기반의 엔터프라이즈 SSO. 팀과 커뮤니티 멤버의 인증을 중앙에서 관리하세요.
Webhook 로그 및 모니터링
모든 webhook 이벤트에 대한 전체 전송 로그를 제공합니다. 실패한 전송을 디버깅하고, payload를 검사하며, 통합 상태를 모니터링하세요.
오픈 API 엔드포인트
모든 엔드포인트는 https://api.mateflow.com/site_open_api/v1 아래에 있으며, POST 메서드와 JSON 본문을 사용하고 명시된 범위를 가진 API 키가 필요합니다.
- POST/site/getsite.read사이트 정보 조회
- POST/feed/listcontent.read피드 목록 조회
- POST/post/searchcontent.read게시물 검색
- POST/post/createcontent.write게시물 작성
- POST/media/get_tokenmedia.write미디어 업로드 토큰 발급
빠른 시작
세 단계로 시작하기
계정 만들기
무료로 가입하고 Creator Dashboard에서 첫 번째 커뮤니티 사이트를 만드세요.
API keys 생성
커뮤니티 관리 콘솔(설정 → 연동)에서 API 액세스를 활성화하고 범위 지정 키를 생성하세요. Growth, Business, Enterprise 플랜에서 사용할 수 있습니다.
첫 번째 호출 실행
X-API-Key 헤더로 첫 요청을 보내세요. 모든 엔드포인트는 JSON POST 요청을 받습니다.
API 호출 시작하기
주요 언어별 빠른 예제입니다. sk_live_xxx를 관리 콘솔에서 만든 실제 키로 교체하세요.
curl -X POST \
https://api.mateflow.com/site_open_api/v1/post/search \
-H "X-API-Key: sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"keyword": "hello", "limit": 20}'const res = await fetch(
"https://api.mateflow.com/site_open_api/v1/post/create",
{
method: "POST",
headers: {
"X-API-Key": "sk_live_xxx",
"Content-Type": "application/json",
},
body: JSON.stringify({ title: "Hello", content: "From the API!" }),
}
);
const data = await res.json();import requests
res = requests.post(
"https://api.mateflow.com/site_open_api/v1/site/get",
headers={"X-API-Key": "sk_live_xxx"},
json={},
)
data = res.json()SDK 로드맵
Node.js, Python, Go용 공식 SDK가 로드맵에 포함되어 있습니다. 그때까지는 REST API를 모든 HTTP 클라이언트와 함께 사용할 수 있습니다. 전체 API 문서는 곧 제공될 예정입니다.