참조
API 레퍼런스
호스팅된 OpenAPI 레퍼런스의 위치, 인증 방법, 모든 응답의 형태, 속도 제한입니다.
완전한 Polylane API 레퍼런스는 플랫폼이 제공하는 OpenAPI 명세에서 생성되므로, 배포된 것과 항상 일치합니다.
인증
워크스페이스 API 키를 x-api-key 헤더로 보내거나, OAuth 액세스 토큰을 Authorization: Bearer로 보내세요. 둘 다 콘솔에서 만듭니다. API 키와 OAuth 클라이언트를 참고하세요.
Terminal
curl https://api.polylane.com/v1/workspaces \
-H "x-api-key: $POLYLANE_API_KEY"
응답 형식
모든 JSON 응답은 같은 봉투를 사용합니다.
| 필드 | 설명 |
|---|---|
success | 요청이 성공하면 true, 실패하면 false. |
message | 성공 시 message가 상태를 설명하는 객체. 실패 시 null. |
error | 성공 시 null. 실패 시 message, 선택적 detail, 선택적 metadata를 가진 객체. |
result | 성공 시 페이로드. 실패 시 없음. |
{
"success": true,
"message": { "message": "Successful request" },
"error": null,
"result": { "items": [], "count": 0 }
}
속도 제한
| 대상 | 제한 |
|---|---|
| REST API | 자격 증명당 60초에 5,000개 요청 |
| 플랫폼 MCP 서버 | 자격 증명당 60초에 600개 요청 |
응답은 RateLimit-Limit과 RateLimit-Policy 헤더로 정책을 알립니다. 제한을 넘으면 API는 창의 남은 시간을 초 단위로 담은 Retry-After 헤더와 함께 429로 응답합니다. 그 시간이 지날 때까지 물러났다가 다시 시도하세요.
모든 작업은 같은 명세에서 생성되는 CLI에서도 호출할 수 있습니다.
관련 문서
- 이 요청들이 사용하는 자격 증명을 만들려면 API 키와 OAuth 클라이언트를 참고하세요.
- 터미널이나 스크립트에서 API를 호출하려면 CLI를 참고하세요.
- 에디터 에이전트에서 같은 데이터에 접근하려면 플랫폼 MCP 서버를 참고하세요.