메인 콘텐츠로 건너뛰기
Tiro API로 노트, 전사, 요약, 음성 처리에 프로그래밍 방식으로 접근할 수 있어요.

Base URL

모든 API 요청은 다음 주소로 보내세요.
https://api.tiro.ooo

Rate Limit

공정한 사용과 시스템 안정성을 위해 Tiro API는 다음과 같은 rate limit을 적용해요.

Rate Limit 초과

rate limit을 초과하면 429 Too Many Requests 응답을 받아요.
{
  "error": {
    "code": 429001,
    "message": "Rate limit exceeded. Try again in 3600 seconds",
    "detail": "Hourly limit of 1000 requests exceeded"
  }
}

응답 형식

모든 API 응답은 일관된 JSON 형식을 따라요.

성공 응답 (목록)

{
  "content": [...],
  "nextCursor": "opaque-cursor-string"
}

성공 응답 (단일 리소스)

{
  "id": "resource-id",
  "createdAt": "2024-01-01T00:00:00Z",
  ...
}

에러 응답

에러에는 디버깅에 도움이 되는 상세 정보가 포함돼요.
{
  "error": {
    "code": 400000,
    "message": "Human readable error message",
    "detail": null
  }
}