본문으로 건너뛰기

개발자

Mateflow API로개발하세요.

키 하나가 커뮤니티 하나에 대응합니다. 게시물·피드·스페이스·멤버를 읽고, 멤버를 대신해 게시하고, 모든 이벤트를 웹훅으로 받습니다 — 전부 하나의 JSON API에서.

기능

연동에 필요한 모든 것

범위가 지정된 API 키

커뮤니티 관리자 콘솔에서 키를 만들고 각 키에 필요한 스코프만 부여하세요. X-API-Key 헤더로 인증하며, 관리할 세션은 없습니다.

Growth 이상

JSON API

하나의 일관된 응답 봉투로 커뮤니티를 읽고 씁니다. 모든 엔드포인트는 /site_open_api/v1 아래에 있고, JSON 본문의 POST를 받으며, 커뮤니티는 키에서 역추적됩니다.

Growth 이상

웹훅

엔드포인트를 등록하면 이벤트가 발생하는 즉시 받습니다. 전송 본문에는 안정적인 event_id가 있어 재시도를 중복 제거할 수 있고, 같은 id가 Slack·Discord·Zapier 쪽에도 도착합니다.

Growth 이상

통합

통합 허브에서 Slack, Discord, Zapier를 연결하고, 앱 카탈로그를 둘러보고, 연결된 앱을 한곳에서 관리하세요.

싱글 사인온

두 번째 자격 증명 세트를 유지하는 대신, 팀과 멤버의 인증을 한곳으로 모으세요.

Business 이상

전송 로그

모든 웹훅 전송 시도가 페이로드와 응답과 함께 기록됩니다. 실패한 전송을 살펴보고, 무엇을 반환했는지 확인하고, 콘솔에서 재시도하세요.

Growth 이상

24개 엔드포인트, 하나의 봉투

모두 https://api.mateflow.com/site_open_api/v1 아래에 있으며 JSON 본문의 POST를 사용합니다. 아래는 대부분의 연동이 가장 먼저 쓰는 것들이며, 전체 목록은 레퍼런스에 있습니다.

BASE URLhttps://api.mateflow.com/site_open_api/v1
  • POST/capabilities/get스코프 불필요키·스코프·남은 할당량 확인
  • POST/site/getsite.read커뮤니티 프로필과 설정 읽기
  • POST/feed/listcontent.read커뮤니티 피드 페이지 넘기기
  • POST/post/searchcontent.read게시물 검색
  • POST/post/createcontent.write멤버로서 게시하기
  • POST/space/listspaces.read해당 시점에서 보이는 스페이스 목록
  • POST/member/lookupmembers.read이메일로 멤버 찾기
  • POST/media/get_tokenmedia.write미디어 업로드 토큰 받기

빠른 시작

세 단계로 시작하기

단계 01

API 접근 켜기

API 접근은 커뮤니티 소유자가 활성화하는 플랜 기능입니다. 없으면 모든 호출이 22203을 반환하고 키도 만들 수 없습니다 — 코드가 아니라 여기서 시작하세요.

단계 02

범위를 지정한 키 만들기

커뮤니티 관리자 → 통합 → API Keys. 필요한 스코프만 고르세요. 키가 만들어지면 스코프는 고정됩니다. 전체 키는 단 한 번만 표시됩니다.

단계 03

먼저 /capabilities/get 호출하기

스코프, API 접근 여부, 남은 할당량을 알려줍니다. 플랜 게이트나 할당량이 나머지 전부를 막고 있을 때에도 답하는 유일한 엔드포인트이며, 할당량도 소모하지 않습니다.

사용량과 한도

플랜별 허용량

일일 할당량은 인증을 통과한 모든 요청을 세며 UTC 0시에 초기화됩니다. 할당량 0은 '설정하지 않아서 무제한'이 아니라 닫힌 문이며, 모든 호출이 22204를 반환합니다.

플랜오픈 API일일 요청 수웹훅 엔드포인트 수
Starter미포함
Growth포함5,0005
Business포함10,00020
Enterprise포함무제한무제한

일일 할당량 위에 키 단위로 적용되는 버스트 한도가 있습니다 — 레퍼런스의 레이트 리밋을 참고하세요.

첫 호출, 세 가지 방법

같은 요청을 언어별로. 다른 코드를 쓰기 전에 키가 동작하는지부터 확인하세요. mfk_xxx는 관리자 콘솔의 실제 키로 바꾸세요.

cURL
curl -X POST \
  https://api.mateflow.com/site_open_api/v1/capabilities/get \
  -H "X-API-Key: mfk_xxx" \
  -H "Content-Type: application/json" \
  -d '{}'
JavaScript
const res = await fetch(
  "https://api.mateflow.com/site_open_api/v1/capabilities/get",
  {
    method: "POST",
    headers: {
      "X-API-Key": process.env.MATEFLOW_API_KEY,
      "Content-Type": "application/json",
    },
    // Endpoints that take no parameters still want a JSON body.
    body: "{}",
  },
);
const { code, data } = await res.json();
// Branch on `code`, never on the HTTP status:
// 22203 and 22204 are 403, and only 10202 is throttling.
if (code !== 0) throw new Error(`Mateflow API error ${code}`);
console.log(data.scopes, data.quota_used, data.quota_limit);
Python
import os, requests

res = requests.post(
    "https://api.mateflow.com/site_open_api/v1/capabilities/get",
    headers={"X-API-Key": os.environ["MATEFLOW_API_KEY"]},
    json={},
)
body = res.json()
if body["code"] != 0:
    raise RuntimeError(f"Mateflow API error {body['code']}")

print(body["data"]["scopes"], body["data"]["api_access"])

OpenAPI 계약

기계가 읽을 수 있는 계약이 모든 경로와 요청·응답 스키마를 담고 있으며, 어떤 클라이언트 제너레이터에도 넣을 수 있습니다. 공식 SDK는 로드맵에 있고, 그때까지는 직접 생성하세요.

openapi.json 내려받기

레퍼런스

전체 API 레퍼런스

스코프, 페이지네이션, 멱등성, 오류 코드, 레이트 리밋, 웹훅 중복 제거 — 그리고 배포한 뒤에야 물어뜯는 몇 가지 예외들.

시작할 준비가 되셨나요?

계정을 만들고 API 키를 발급해 Mateflow를 업무 흐름에 연결하세요.

14일 무료 체험 · 신용카드 불필요

무료 체험 시작하기