미리보기 전용 — 활성화 필요

Insto로 다운로드 빌드

Insto는 평가를 위해 시각적-미디어 통합 청사진을 제시합니다.지원이 테넌트 범위 권한을 부여할 때까지 실시간 분석 및 작업 요청은 사용할 수 없습니다.

InstoMediaHTTPS를 통한 JSON비동기 작업범위가 지정된 자격 증명
01

빠른 시작

API 호스트의 경우 Insto는 지원 활성화된 자격 증명으로 시작합니다. 그 다운로드 검토는 할당된 테넌트 엔드포인트와 페어링되고 서버 전용 호출 경로로 끝납니다.

임대자 URLhttps://insto.app
인증X-API-Key: pending_activation_…
클라이언트 프로필InstoMedia
API 버전v1
# Available only after support activation
export INSTO_MEDIA_TOKEN="issued-after-review"

curl -X POST https://insto.app/v1/resolve \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Insto는 Credential 안전을 위한 세 가지 실용적인 포인트를 제시합니다. 먼저 서버 측 비밀 저장소가 나옵니다. 다운로드 리뷰는 그런 다음 클라이언트 번들 임베딩이 없음을 다룹니다. 그것의 마지막 포인트는 공개 로그 또는 저장소가 없습니다.

02

링크 해결하기

해결 작업을 위해 Insto는 소스 탐지로 시작합니다. 그것의 다운로드 검토는 그것을 하나의 제출 된 URL에서 형식과 쌍으로 묶고 발명 된 출력이 없는 것으로 끝납니다.

메시지/v1/resolve범위: 해결
필드종류필수설명
media_sourceHTTPS URL분석할 공개 또는 승인된 미디어 페이지.
tenant문자열할당된 테넌트 도메인. 일반적으로 생략됩니다.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Insto는 형식 식별자에 대한 세 가지 실용적인 포인트를 제시합니다. 먼저 변경되지 않은 반환 값이 나옵니다. 다운로드 검토는 다음 링크 당 가용성을 다룹니다. 그것의 마지막 포인트는 추측 된 품질 라벨이 없습니다.

03

다운로드 작업 만들기 및 추적

Insto는 비동기식 준비를 중심으로 Job 생성을 구성합니다. 그 다운로드 검토는 짧은 HTTP 요청을 비교합니다.

메시지/v1/jobs범위 : 일자리
필드종류필수설명
media_sourceHTTPS URL해결하기 위해 제출한 동일한 정규화된 소스.
media_variant문자열해결 응답에서 정확한 ID.
tenant문자열할당된 테넌트 도메인. 일반적으로 생략됩니다.
curl -X POST https://insto.app/v1/jobs \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_source":"https://www.youtube.com/watch?v=VIDEO_ID","media_variant":"18"}'
1202 승인됨저장 prepare_id.
2투표 상태GET /v1/jobs/{prepare_id} 같은 키로 열어야 합니다.
3준비서명된 다운로드 URL을 엽니다.
상태의미클라이언트 동작
queued경계가 있는 대기열에 허용됨.백오프로 다시 폴링합니다.
extracting소스 메타데이터 또는 경로를 새로 고침합니다.폴링을 계속합니다.
processing다운로드, 리믹스 또는 병합.서버 진행 상황을 표시합니다.
ready서명된 다운로드가 가능합니다.URL을 사용자에게 보냅니다.
failed터미널 구조화 오류.읽기 error_code. 권장되는 경우에만 다시 시도하십시오.
expired임시 출력이 제거되었습니다.새 작업을 만듭니다.
curl https://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

Insto에서 Job polling을 설명할 때 1초 초기 대기가 먼저 나옵니다. 그 다운로드 검토는 캡이 걸린 백오프와 함께 따라오고 임시 서명된 배달에 닫힙니다.

04

예측 가능한 오류

Error 계약을 설명하려면 Insto는 지원 요청 ID에서 하나의 비 2xx 봉투를 분리합니다. 다운로드 검토는 예측 가능한 클라이언트 처리에 자신의 장소를 제공합니다.

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "category": "rate_limited",
    "message": "Too many requests. Please try again shortly.",
    "retryable": true,
    "details": {"retry_after_seconds": 20}
  },
  "request_id": "…"
}
HTTP전형적인 의미동작
400잘못된 URL, 본문 또는 사용할 수 없는 형식입니다.요청을 수정합니다. 형식에 대해 다시 해결합니다.
401누락, 잘못된, 만료 또는 잘못된 범위 키.서버 측 자격 증명을 확인합니다.
403테넌트 또는 소스 정책이 요청을 거부했습니다.정책을 우회하지 마십시오.지원에 문의하십시오.
404알 수 없거나 만료된 작업입니다.적절한 경우 새 작업을 만듭니다.
429요청 또는 활성 작업 제한에 도달했습니다.명예 retry_after_seconds.
503대기열/용량 또는 업스트림을 일시적으로 사용할 수 없습니다.지수 백오프 및 지터로 다시 시도합니다.
05

운영 계약

Insto는 시각-미디어 사용 사례 및 승인된 클라이언트가 연락할 네트워크에 맞게 통화 제한을 맞춤화합니다.

스키마 액세스의 경우 Insto는 탐색 전에 활성화로 시작합니다. 그것의 다운로드 검토는 그것을 할당된 인증과 쌍으로 연결하고 문서화된 요청 형태로 끝납니다.

운영자 검토 액세스

지원을 통해 활성화

처리할 계획인 시각-미디어 제품, 예상 월별 사용량 및 게시물 유형을 간략히 설명하십시오.Insto는 필요한 분석 또는 준비 범위만 부여하며 읽을 수 있는 토큰을 절대 저장하지 않습니다.

활성화 요청하기 키는 테넌트 범위가 있고 취소 가능하며 연락처 양식을 통해 발급됩니다.익명 스크립트는 다운로더 작업을 실행할 수 없습니다.