Make Agent Fast 문서
SDK 상태
레지스트리 제공 여부를 가정하지 않고 안정적인 REST API 또는 소스 전용 미리보기 클라이언트를 선택합니다.
이 페이지 한눈에
레지스트리 제공 여부를 가정하지 않고 안정적인 REST API 또는 소스 전용 미리보기 클라이언트를 선택합니다.
API 요청 경로범위 키 → 버전 리소스 → 서명된 응답
REST 사용 가능OpenAPISDK 미리보기
현재 지원되는 공개 연동 표면은 버전이 지정된 REST API입니다. JavaScript, Python, 프레임워크 클라이언트 소스는 제품 저장소에 있지만 패키지는 현재 npm 또는 PyPI에 게시되지 않았습니다.
제공 상태#
| 클라이언트 | 상태 | 사용 방법 |
|---|---|---|
| HTTPS REST | 사용 가능 | 모든 서버 HTTP 클라이언트에서 https://makeagent.fast/api/v1 호출 |
| OpenAPI 문서 | 사용 가능 | /api/openapi.json을 내려받아 클라이언트 생성 전에 검토 |
@make-agent-fast/sdk | 소스 미리보기 — npm 미게시 | 레지스트리 릴리스 링크가 이 페이지에 추가되기 전에는 프로덕션 프로젝트에 import를 추가하지 않음 |
makeagentfast Python 패키지 | 소스 미리보기 — PyPI 미게시 | PyPI 릴리스가 연결될 때까지 requests, httpx 또는 Python 표준 라이브러리 사용 |
| React, Vue, Svelte 어댑터 | 소스 미리보기 — npm 미게시 | 해당 프레임워크의 문서화된 스크립트 로더 패턴 사용 |
| 웹 컴포넌트 | 소스 미리보기 — npm 미게시 | 표준 embed.js 로더 사용 |
SDK 없이 JavaScript 사용#
const response = await fetch("https://makeagent.fast/api/v1/sites?limit=100", {
headers: {
Authorization: `Bearer ${process.env.MAF_API_KEY}`,
Accept: "application/json",
},
});
const body = await response.json();
if (!response.ok) {
console.error(body.error.code, body.error.request_id);
throw new Error(`Make Agent Fast request failed (${response.status})`);
}
for (const site of body.data) console.log(site.id, site.title);API 키는 서버에 보관하세요. React, Vue, Svelte 브라우저 번들은 자신의 백엔드를 호출하거나 공개 임베드 로더를 설치해야 하며 시크릿으로 관리 API를 직접 호출하면 안 됩니다.
SDK 없이 Python 사용#
import json
import os
import urllib.request
request = urllib.request.Request(
"https://makeagent.fast/api/v1/sites?limit=100",
headers={
"Authorization": f"Bearer {os.environ['MAF_API_KEY']}",
"Accept": "application/json",
},
)
with urllib.request.urlopen(request, timeout=20) as response:
payload = json.load(response)
for site in payload["data"]:
print(site["id"], site["title"])프로덕션에서는 urllib.error.HTTPError를 처리하고 안정적인 오류 응답 형식에 따라 JSON 본문을 파싱하세요.
생성된 클라이언트#
OpenAPI 생성은 문서에 애플리케이션이 의존하는 작업과 스키마가 포함될 때만 유용합니다. 내려받은 명세를 고정하고 검토 가능한 디렉터리에 생성한 뒤 업그레이드 전 모든 diff를 확인하세요.
curl --fail-with-body https://makeagent.fast/api/openapi.json \
--output make-agent-fast.openapi.json라이브 URL에서 클라이언트를 자동 재생성해 곧바로 배포하지 마세요. 새로운 추가 필드가 클라이언트를 깨뜨리면 안 되지만 생성기 동작과 메서드 이름은 바뀔 수 있습니다.
공개 SDK 릴리스 조건#
미리보기 클라이언트를 사용 가능으로 표시하려면 다음이 필요합니다.
- 공개 레지스트리 페이지와 변경 불가능한 시맨틱 버전
- 설치, 업그레이드, 지원 런타임 안내
- 완전한 API 계약에서 생성한 타입 지정 요청 및 응답 모델
- HTTP 상태와 요청 ID를 유지하는 구조화된 오류
- 커서를 불투명한 값으로 다루는 페이지네이션 도우미
- 변경 요청의 명시적인 멱등성 키 지원
- 현재
/api/v1계약에 대한 CI 테스트와 게시된 변경 기록