https://ffast.appFFast로 다운로드 빌드
FFast는 공개 호출을 활성화하지 않고도 의도된 API 형태를 노출합니다. 운영자는 제안된 통합을 검토한 후 자격 증명과 측정된 할당량을 활성화합니다.
빠른 시작
FFast는 지원 활성화 자격 증명을 통해 API 호스트에 접근한 후 할당된 테넌트 엔드포인트로 이동합니다. 빠른 검토는 서버 전용 호출 경로를 명확히 유지합니다.
X-API-Key: pending_activation_…FfastPipelinev1# Available only after support activation
export FFAST_PIPELINE_KEY="issued-after-review"
curl -X POST https://ffast.app/v1/resolve \
-H "X-API-Key: $FFAST_PIPELINE_KEY" \
-H "Content-Type: application/json" \
-d '{"fast_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'자격 증명 안전을 위해 FFast는 클라이언트 번들 삽입 없이 서버 측 비밀 저장소를 확인합니다. 이 빠른 검토는 공개 로그나 저장소를 남기지 않습니다.
링크 해결하기
FFast는 소스 감지를 통해 Resolve 작업에 접근한 다음, 제출된 하나의 URL에서 포맷을 처리합니다. 빠른 검토는 발명된 출력물을 명시적으로 저장하지 않습니다.
/v1/resolve범위: 해결| 필드 | 종류 | 필수 | 설명 |
|---|---|---|---|
fast_source | HTTPS URL | 네 | 분석할 공개 또는 승인된 미디어 페이지. |
tenant | 문자열 | 네 | 할당된 테넌트 도메인. 일반적으로 생략됩니다. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}형식 식별자의 경우, FFast는 링크별 가용성 전에 반환된 값을 변경 없이 확인합니다. 이 빠른 검토는 추측된 품질 레이블을 명확히 하지 않습니다.
다운로드 작업 만들기 및 추적
FFast는 비동기 준비를 먼저 식별하여 작업 생성을 처리합니다. 이어서 짧은 HTTP 요청을 수행하며 제한된 작업자 실행을 유지합니다.
/v1/jobs범위 : 일자리| 필드 | 종류 | 필수 | 설명 |
|---|---|---|---|
fast_source | HTTPS URL | 네 | 해결하기 위해 제출한 동일한 정규화된 소스. |
output_code | 문자열 | 네 | 해결 응답에서 정확한 ID. |
tenant | 문자열 | 네 | 할당된 테넌트 도메인. 일반적으로 생략됩니다. |
curl -X POST https://ffast.app/v1/jobs \
-H "X-API-Key: $FFAST_PIPELINE_KEY" \
-H "Content-Type: application/json" \
-d '{"fast_source":"https://www.youtube.com/watch?v=VIDEO_ID","output_code":"18"}'pipeline_run.GET /v1/jobs/{pipeline_run} 같은 키로 열어야 합니다.| 상태 | 의미 | 클라이언트 동작 |
|---|---|---|
queued | 경계가 있는 대기열에 허용됨. | 백오프로 다시 폴링합니다. |
extracting | 소스 메타데이터 또는 경로를 새로 고침합니다. | 폴링을 계속합니다. |
processing | 다운로드, 리믹스 또는 병합. | 서버 진행 상황을 표시합니다. |
ready | 서명된 다운로드가 가능합니다. | URL을 사용자에게 보냅니다. |
failed | 터미널 구조화 오류. | 읽기 error_code. 권장되는 경우에만 다시 시도하십시오. |
expired | 임시 출력이 제거되었습니다. | 새 작업을 만듭니다. |
curl https://ffast.app/v1/jobs/PIPELINE_RUN \
-H "X-API-Key: $FFAST_PIPELINE_KEY"작업 폴링은 FFast에서 1초 초기 대기 후 시작됩니다. 다음 뷰는 제한된 백오프를 다룹니다. 페이지는 임시 서명된 배달을 계속 표시합니다.
예측 가능한 오류
FFast의 빠른 검토는 오류 계약에 대해 하나의 비 2xx 봉투를 검토합니다. 다음에 지원 요청 ID를 표시하며 예측 가능한 클라이언트 처리를 가리지 않습니다.
{
"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 | 대기열/용량 또는 업스트림을 일시적으로 사용할 수 없습니다. | 지수 백오프 및 지터로 다시 시도합니다. |
운영 계약
FFast는 업스트림 플랫폼에 안전하지 않은 부하를 배치하지 않고 핸드오프를 반응형으로 유지하는 측정된 할당량을 활성화합니다.
- idempotent 애플리케이션 로직을 사용하고 동일한 사용자 클릭에 대해 중복 작업을 시작하지 마십시오.
- 캐시는 메타데이터를 간략하게 해결하지만 서명된 다운로드 URL은 항상 만료된 것으로 취급합니다.
- 지터가 있는 한정된 지수 백오프를 사용하여
429,503그리고 재시도 가능한 오류들. - 공용 미디어 또는 액세스 권한이 있는 미디어만 처리합니다. DRM 및 액세스 제어가 우회되지 않습니다.
- 요청 ID와 작업 ID를 개인 운영 로그에 보관하십시오. 제출된 URL을 불필요하게 로그하지 마십시오.
FFast는 탐색 전에 활성화를 통해 스키마 접근을 시도한 후 할당된 인증을 수행합니다. 빠른 검토는 문서화된 요청 형식을 명확하게 유지합니다.
지원을 통해 활성화
FFast에 간결한 제품 요약, 트래픽 예상 및 플랫폼 목록을 제공하십시오. 발급된 키가 실제 워크플로우와 일치하도록 메타데이터 검사, 준비된 작업 또는 둘 다가 필요한지 명시하십시오.
활성화 요청하기 키는 테넌트 범위가 있고 취소 가능하며 연락처 양식을 통해 발급됩니다.익명 스크립트는 다운로더 작업을 실행할 수 없습니다.