빠른 시작

ShortsMonkey 계정과 HTTPS 액세스 권한이 있는 서버측 터미널을 준비합니다. cURL 예제에는 cURL가 필요합니다. JavaScript에는 가져오기 기능이 있는 Node.js가 필요합니다. Python에는 요청이 필요합니다. 표시된 모든 키는 자리 표시자입니다. 자신의 계정에 있는 키를 사용하세요.

로그인하고 API 콘솔을 열고 일회성 공개에서 전체 키를 복사하세요. REST 요청에는 api:read가 필요합니다. MCP 도구에는 mcp:read가 필요합니다. 두 통합에 대해 둘 다 선택하거나 통합에 필요한 권한만 선택하세요.

export SHORTSMONKEY_API_KEY="sm_live_..."

GET /v1/auth/verify, GET /v1/credits, GET /v1/credits/costs, 상태 확인 및 키 관리는 일일 데이터 호출 10회를 차감하지 않습니다. 인증과 소유권 확인은 유지됩니다.

터미널에서 curl -i https://api.shortsmonkey.com/v1/auth/verify -H "Authorization: Bearer $SHORTSMONKEY_API_KEY"를 실행하세요. 이 REST 검사에는 api:read도 필요합니다. HTTP 200을 예상한 다음 data.authenticated가 true이고 data.scopes에 api:read가 포함되어 있는지 확인하세요. 성공적인 인증은 비어 있지 않은 순위를 보장하지 않습니다.

아래 예제 중 하나를 실행하세요. 세 가지를 모두 실행할 필요는 없습니다. 요청은 저장된 안정적인 중국어 장편 비디오 스냅샷을 읽고 라이브 YouTube 가져오기를 트리거하지 않습니다. 먼저 HTTP 상태를 확인하세요. 200이 아닌 응답의 경우 오류 JSON를 순위 데이터로 처리하는 대신 error.code를 읽으십시오.

data.all_data.items에는 요청 필터 이전의 현재 페이지가 포함되어 있습니다. data.filter_data.items에는 기본값 및 요청 필터 이후의 현재 페이지가 포함되어 있습니다. 두 배열 모두 비어 있을 수 있으며 해당 개수는 다를 수 있습니다. 빈 배열은 인증 실패가 아닙니다. Meta.snapshot_at를 사용하여 데이터의 수명을 평가하고 진단을 위해 Meta.request_id를 유지하세요.

다른 페이지의 경우 all_data.next_cursor를 all_cursor로 전달하고 filter_data.next_cursor를 filter_cursor로 전달하여 원래 필터를 유지합니다. null은 해당 결과 세트를 종료합니다. cursor를 교체하지 마십시오. 새로운 REST 데이터 요청이 성공할 때마다 일일 호출이 사용됩니다. Credits.unlimited가 true라고 해서 무제한 데이터 요청을 의미하는 것은 아닙니다. daily_usage.remaining을 확인하세요.

401 INVALID_API_KEY: 전체 sm_live_ 키, Bearer 뒤의 공백, 환경 변수, 키가 만료되었는지, 취소되었는지 또는 순환 유예 기간이 지났는지 확인하세요. 403 INSUFFICIENT_SCOPE의 경우 api:read;를 확인하세요. 403 ACCOUNT_DISABLED의 경우 계정 상태를 확인하고 지원팀에 문의하세요. 반복적으로 재시도해도 인증이나 권한이 복구되지 않습니다.

오류 코드로 429를 구별합니다. API_DAILY_LIMIT_REACHED는 아시아/상하이 00:00까지 기다려야 합니다. RATE_LIMITED에서는 빈도와 동시 요청을 줄이고 제공 시 Retry-After를 존중해야 합니다. 503 DATA_STALE은 저장된 스냅샷이 너무 오래되었음을 의미합니다. SERVICE_UNAVAILABLE은 일시적인 사용 불가능을 의미합니다. 백오프와 함께 제한된 재시도를 사용하고 요청 ID를 유지합니다.

서버 측 환경 변수 또는 비밀 저장소에 키를 보관하고 Authorization 헤더로 보냅니다. 브라우저 코드, URLs, Git, 스크린샷, 로그 또는 분석에 넣지 마십시오. 진단을 위해 요청 ID, 작업, 시간, 상태, 오류 코드만 공유합니다. 노출된 경우 콘솔에서 키를 순환하거나 취소하고 서버 구성을 업데이트하세요.