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

​
Base URL

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

​
Rate Limit

공정한 사용과 시스템 안정성을 위해 Tiro API는 API Key 하나당 60초에 600 요청까지 허용해요. 초과하면 429 응답과 함께 다시 시도할 시점을 알려주는 Retry-After·X-RateLimit-* 헤더를 받아요.

​
Rate Limit 초과

rate limit을 초과하면 429 Too Many Requests 응답을 받아요. 
{
  "error": {
    "code": 429001,
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "detail": "Limit of 600 requests per 60 seconds 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
  }
}