요청 제한

계정마다 60초 구간당 링크 생성 호출을 30회 할 수 있으며, REST POST /api/v1/links, POST /api/v1/uploads, POST /api/v1/sheets와 MCP create_links가 이 한도를 공유합니다. 업로드 예약과 시트 제출은 각각 1회를 사용하며 하위 링크 변환은 사용하지 않습니다. 즉시 처리 요청과 일괄 작업 제출은 입력 개수에 관계없이 각각 1회를 사용합니다.

허용된 생성 요청과 한도 초과로 거부된 요청에는 구조화된 헤더가 포함됩니다.

RateLimit-Policy: "create-links";q=30;w=60
RateLimit: "create-links";r=29;t=60

q는 할당량이고 w는 구간의 초 단위 길이입니다. r은 남은 호출 수이며 t는 호출 한 자리가 비기까지의 초입니다. 이 값들은 단순 숫자가 아닌 구조화된 필드입니다.

할당량이 소진되면 rate-limited 문제와 초 단위 Retry-After를 포함한 429가 반환됩니다. 기다린 뒤 다시 시도하고 동일 계정을 사용하는 클라이언트들의 호출을 조율하세요. 작업 조회는 링크 생성 할당량을 사용하지 않습니다. 작업의 poll_after_seconds와 Retry-After 안내를 따르세요.

검색 구간섹션 링크 복사

키워드 검색에는 계정마다 60초당 30회의 별도 구간이 있습니다. 검색 허용은 링크 생성 할당량을 사용하지 않습니다. 상품, 상점, 시트 또는 지원되지 않는 링크로 확인된 붙여넣기는 키워드 검색을 건너뛰며 두 구간 모두 사용하지 않습니다. 읽지 못한 붙여넣기는 키워드 검색으로 이어질 수 있습니다.

키워드 검색 허용 단계에 도달한 성공 응답과 검색 제한으로 거부된 응답에는 다음 헤더가 포함됩니다.

RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60

거부된 검색은 search-rate-limited와 Retry-After를 포함한 429를 반환합니다. 헤더 필드의 의미는 위와 같습니다. Idempotency-Key로 생성 요청을 재반환하면 링크 생성 할당량을 추가로 사용하지 않습니다. 429는 재반환용으로 저장하지 않습니다.