# अपने भंडारण के लिए एक वीडियो डाउनलोड करें

एक MP4 को अपने Amazon S3 बाल्टी में वितरित करें, फिर फ़ाइल को Python या Bash के साथ पुनर्प्राप्त और सत्यापित करें।

कैनोनिकल संदर्भ: https://flashdata.dev/hi/docs/guides/download-video-recipe
समीक्षित: 2026-11-05 द्वारा FlashData

<a id="prepare"></a>

## शुरू करने से पहले

youtube_download अनुमति और उपलब्ध क्रेडिट के साथ मालिक का उपयोग करें। डाउनलोड अस्थायी एजेंट परीक्षण पहुँच में शामिल नहीं है। आपको एक मौजूदा Amazon S3 बाल्टी की आवश्यकता है और एक वीडियो जिसे आप डाउनलोड करने के लिए अधिकृत हैं।

Python 3.10+ को अनुरोधों और boto3, या Bash के साथ cURL, jq, OpenSSL और AWS CLI v2 के साथ चुनें। Windows पर, Git Bash का उपयोग Bash संस्करण के लिए किया जाता है।

| क्रेज़ी | के लिए इस्तेमाल किया |
| --- | --- |
| FLASHDATA_API_KEY | नौकरी जमा करें और अपनी स्थिति और डिलीवरी रिकॉर्ड को पुनर्प्राप्त करें। |
| FLASHDATA_STORAGE_ACCESS_KEY / FLASHDATA_STORAGE_SECRET_KEY | एक S3 अपलोड पहचान अपने चयनित बाल्टी और उपसर्ग को लिखने के लिए FlashData को भेजी गई है। |
| आपकी स्थानीय AWS प्रोफ़ाइल या भूमिका | कदम 4 में boto3 या AWS CLI के साथ निजी वस्तु को पढ़ें। इसे s3:GetObject एक्सेस की आवश्यकता है। |

- [API कुंजी लें](https://flashdata.dev/app/api-keys)
- [भंडारण विन्यास](https://flashdata.dev/hi/docs/guides/youtube-download-guide/reference.md#storage)
- [मूल्य निर्धारण](https://flashdata.dev/hi/docs/guides/credits-and-billing/reference.md)
- [स्थानीय एडब्ल्यूएस एक्सेस को कॉन्फ़िगर करें](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-authentication.html)

<a id="input"></a>

## 1. वीडियो और गंतव्य चुनें

अपने रिपॉज़िटरी के बाहर एक निजी डाउनलोड वीडियो फ़ोल्डर बनाएं। वहाँ request.json को सहेजें और उस फ़ोल्डर में एक टर्मिनल खोलें। अपने AWS क्षेत्र के साथ अपने बाल्टी नाम और क्षेत्र के साथ storage_url को बदलें; एक 11-character वीडियो ID का उपयोग करें।

यह नुस्खा ऑडियो को MP4 के रूप में वितरित करता है, 720p तक, recipes/clip-001/. के तहत बाल्टी को निजी रखें। एक अलग डाउनलोड के लिए एक ताजा उपसर्ग का उपयोग करें ताकि एक और काम इस ऑब्जेक्ट के पथ को ओवरराइट नहीं कर सके।

### download-video/request.json

```json
{
  "source": "youtube_download",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "download_type": "audio_video",
    "video_quality": "<=720",
    "output_format": "mp4",
    "storage": {
      "storage_type": "s3",
      "storage_url": "your-media-bucket",
      "region": "us-east-1",
      "object_prefix": "recipes/clip-001"
    }
  }
}
```


<a id="submit"></a>

## 2. एक डाउनलोड नौकरी जमा करें

एक संस्करण चुनें और इसे चलाने से पहले अपनी स्क्रिप्ट को request.json के बगल में सहेजें। स्क्रिप्ट ने ऊपर तीन पर्यावरण चर पढ़े या उनके लिए छिपे हुए प्रॉम्प्ट पर पूछते हैं। एजेंट उन्हें अपने गुप्त स्टोर से आपूर्ति करना चाहिए। request.json में कुंजियों को न रखें।

एक नया काम-001 फ़ोल्डर एक async अनुरोध भेजता है। यह अनुरोध को बिना क्रेडेंशियल, टाइमस्टैम्प, HTTP उत्तर और नौकरी ID के बिना बचाता है। उस फ़ोल्डर को जमा करना बंद कर देता है; यह एक दूसरा काम नहीं करता है।

### Python

#### अपने Python वातावरण में स्थापित करें

```bash
python -m pip install requests boto3
```

#### download-video/submit.py

```python
# Save as download-video/submit.py.
import getpass
import json
import os
import re
import sys
from datetime import datetime, timezone
from pathlib import Path

import requests

ROOT = Path(__file__).resolve().parent


def read_json(path):
    return json.loads(path.read_text(encoding="utf-8-sig"))


def secret(name):
    value = os.environ.get(name) or getpass.getpass(name + ": ")
    if not value.strip():
        raise ValueError("Missing " + name)
    return value


def main():
    os.umask(0o077)
    folder = sys.argv[1]
    if not re.fullmatch(r"[A-Za-z0-9_-]+", folder):
        raise ValueError("Use a simple output folder name, such as job-001.")
    directory = ROOT / folder
    if directory.exists():
        raise ValueError("Keep this attempt. Run collect.py with the same folder.")
    request = read_json(ROOT / "request.json")
    storage = request["params"]["storage"]
    if (request["source"] != "youtube_download"
            or not re.fullmatch(r"[A-Za-z0-9_-]{11}", request["video_id"])
            or request["params"]["download_type"] != "audio_video"
            or request["params"]["output_format"] != "mp4"
            or storage["storage_type"] != "s3"
            or set(storage) != {"storage_type", "storage_url", "region", "object_prefix"}
            or not re.fullmatch(r"[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]", storage["storage_url"])
            or not re.fullmatch(r"[a-z0-9-]+", storage["region"])
            or not re.fullmatch(r"[A-Za-z0-9_-]+(/[A-Za-z0-9_-]+)*", storage["object_prefix"])):
        raise ValueError("Check the video, MP4 options and Amazon S3 destination.")
    key = secret("FLASHDATA_API_KEY")
    access = secret("FLASHDATA_STORAGE_ACCESS_KEY")
    secret_key = secret("FLASHDATA_STORAGE_SECRET_KEY")
    directory.mkdir(mode=0o700)
    # Save the plan BEFORE sending. Keep upload credentials out of this file.
    (directory / "request.json").write_text(json.dumps(request, indent=2), encoding="utf-8")
    (directory / "submitted-at.txt").write_text(
        datetime.now(timezone.utc).isoformat(), encoding="utf-8")
    storage.update(access_key=access, secret_key=secret_key)
    response = requests.post(
        "https://data.flashdata.dev/v1/queries", json=request,
        headers={"X-API-Key": key, "Accept": "application/json"},
        timeout=(10, 120), allow_redirects=False)
    (directory / "submission.json").write_bytes(response.content)
    (directory / "submission-headers.txt").write_text(
        "\n".join(f"{k}: {v}" for k, v in response.headers.items()), encoding="utf-8")
    (directory / "submission-http.txt").write_text(str(response.status_code))
    if response.status_code not in (200, 201, 202):
        raise ValueError(f"HTTP {response.status_code}. Inspect the saved attempt.")
    receipt = response.json()
    if (receipt.get("source") != "youtube_download"
            or not re.fullmatch(r"[A-Za-z0-9_-]+", receipt.get("id", ""))):
        raise ValueError("Missing job ID. Check History before submitting again.")
    print("Submitted:", receipt["id"], "— keep", directory)


if __name__ == "__main__":
    try:
        main()
    except (IndexError, KeyError, OSError, ValueError, requests.RequestException) as error:
        print("Network request failed. Keep this attempt and inspect its saved files."
              if isinstance(error, requests.RequestException) else str(error), file=sys.stderr)
        sys.exit(1)
```

#### डाउनलोड वीडियो से भागो/

```bash
python submit.py job-001
```


### Bash

#### अपने उपकरण की जाँच करें

```bash
curl --version
jq --version
openssl version
aws --version
```

#### download-video/submit.sh

```bash
#!/usr/bin/env bash
# Save as download-video/submit.sh.
set -euo pipefail
umask 077
cd -- "$(dirname -- "$0")"
folder=${1:?Usage: bash submit.sh job-001}
[[ "$folder" =~ ^[A-Za-z0-9_-]+$ ]] || exit 2
[[ ! -e "$folder" ]] || { echo 'Keep this attempt. Run collect.sh with the same folder.' >&2; exit 1; }
jq -e '
  .source == "youtube_download" and (.video_id | test("^[A-Za-z0-9_-]{11}$"))
  and .params.download_type == "audio_video" and .params.output_format == "mp4"
  and (.params.storage | .storage_type == "s3"
    and (keys == ["object_prefix","region","storage_type","storage_url"])
    and (.storage_url | test("^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$"))
    and (.region | test("^[a-z0-9-]+$"))
    and (.object_prefix | test("^[A-Za-z0-9_-]+(/[A-Za-z0-9_-]+)*$")))
' request.json >/dev/null
for name in FLASHDATA_API_KEY FLASHDATA_STORAGE_ACCESS_KEY FLASHDATA_STORAGE_SECRET_KEY; do
  if [[ -z "${!name:-}" ]]; then
    read -r -s -p "$name: " "$name"; printf '\n'
  fi
  [[ -n "${!name}" ]] || exit 1
  export "$name"
done
mkdir -- "$folder"
# Save the plan before sending; upload credentials are added only to the pipe.
cp request.json "$folder/request.json"
date -u '+%Y-%m-%dT%H:%M:%SZ' > "$folder/submitted-at.txt"
jq '.params.storage += {
  access_key: env.FLASHDATA_STORAGE_ACCESS_KEY,
  secret_key: env.FLASHDATA_STORAGE_SECRET_KEY
}' "$folder/request.json" |
  curl --silent --show-error --connect-timeout 10 --max-time 120 \
    --request POST 'https://data.flashdata.dev/v1/queries' \
    --header "X-API-Key: $FLASHDATA_API_KEY" --header 'Accept: application/json' \
    --header 'Content-Type: application/json' --data-binary @- \
    --dump-header "$folder/submission-headers.txt" \
    --output "$folder/submission.json" --write-out '%{http_code}' > "$folder/submission-http.txt"
status=$(cat "$folder/submission-http.txt")
[[ "$status" =~ ^20[012]$ ]] || { echo "HTTP $status. Inspect the saved attempt." >&2; exit 1; }
jq -er 'if .source == "youtube_download" and (.id | test("^[A-Za-z0-9_-]+$"))
  then "Submitted: " + .id else error("Missing job ID. Check History before resubmitting.") end' \
  "$folder/submission.json"
```

#### डाउनलोड वीडियो से भागो/

```bash
bash submit.sh job-001
```



<a id="receipt"></a>

### अपेक्षित रसीद

सफलता प्रिंट जमा: job_... और submission.json को बचाता है। रसीद यह पुष्टि करती है कि काम स्वीकार किया गया था; यह पूर्ण डिलीवरी या अंतिम शुल्क नहीं है।

#### job-001/submission.json · संक्षिप्त

```json
{
  "id": "job_example",
  "source": "youtube_download",
  "status": "pending",
  "usage": {
    "credits": 0
  }
}
```


<a id="wait"></a>

## 3. प्रसव के लिए प्रतीक्षा करें और अपने रिकॉर्ड को सहेजें

collect.py को submit.py, या collect.sh के बगल में submit.sh के बगल में सहेजें। उसी जॉब-001 फ़ोल्डर के साथ चलाएं। यह एक बार बचाया नौकरी की जाँच करता है। लंबित या प्रसंस्करण के लिए, 10 सेकंड का इंतजार करें और उसी कमांड को फिर से चलाएं।

जब पूरा हो गया, तो यह delivery.json को बचाता है। यहां एक हस्ताक्षरित रीडायरेक्ट करें JSON डिलीवरी रिकॉर्ड को पुनर्प्राप्त करता है, एमपी4 नहीं; स्क्रिप्ट इसे आपके FlashData कुंजी को अग्रेषित किए बिना अनुसरण करती है। एक बचाया delivery.json किसी अन्य API अनुरोध के बिना पुन: उपयोग किया जाता है।

### Python

#### download-video/collect.py

```python
# Save as download-video/collect.py, beside submit.py.
import os
import re
import sys
from urllib.parse import urlsplit

import requests
from submit import ROOT, read_json, secret


def main():
    os.umask(0o077)
    folder = sys.argv[1]
    if not re.fullmatch(r"[A-Za-z0-9_-]+", folder):
        raise ValueError("Use the saved output folder name.")
    directory = ROOT / folder
    if (directory / "delivery.json").exists():
        print("Already saved:", directory / "delivery.json")
        return
    receipt = read_json(directory / "submission.json")
    job_id = receipt["id"]
    if receipt["source"] != "youtube_download" or not re.fullmatch(r"[A-Za-z0-9_-]+", job_id):
        raise ValueError("Inspect submission.json before continuing.")
    headers = {"X-API-Key": secret("FLASHDATA_API_KEY"), "Accept": "application/json"}
    url = "https://api.flashdata.dev/v2/jobs/" + job_id

    def get(url, name, headers):
        response = requests.get(url, headers=headers, timeout=(10, 120), allow_redirects=False)
        (directory / name).write_bytes(response.content)
        (directory / (name + ".headers")).write_text(
            "\n".join(f"{k}: {v}" for k, v in response.headers.items()), encoding="utf-8")
        (directory / (name + ".http")).write_text(str(response.status_code))
        return response

    status = get(url, "job-status.json", headers)
    if status.status_code != 200:
        raise ValueError(f"HTTP {status.status_code}. Inspect job-status.json and its headers.")
    job = status.json()["job"]
    if job["id"] != job_id or job["source"] != "youtube_download":
        raise ValueError("The job does not match the saved receipt.")
    if job["status"] in ("pending", "processing"):
        print(job["status"] + ". Wait 10 seconds, then run this command again.")
        return
    if job["status"] != "completed":
        raise ValueError("Job " + job["status"] + ". Inspect job-status.json; do not resubmit.")
    result = get(url + "/results", "delivery.pending.json", headers)
    if result.status_code == 302:
        location = result.headers.get("Location", "")
        parsed = urlsplit(location)
        if parsed.scheme != "https" or not parsed.hostname or parsed.username or parsed.password:
            raise ValueError("Expected an HTTPS result URL.")
        # This URL retrieves the JSON delivery record, not the video.
        # Never forward the FlashData key to the signed storage URL.
        result = get(location, "delivery.pending.json", {})
    if result.status_code != 200:
        raise ValueError(f"HTTP {result.status_code}. Run collect.py again after resolving it.")
    delivery = result.json()
    if (delivery.get("source") != "youtube_download" or delivery.get("status") != "done"
            or not isinstance(delivery.get("results"), list) or len(delivery["results"]) != 1):
        raise ValueError("Inspect delivery.pending.json before using the result.")
    (directory / "delivery.pending.json").replace(directory / "delivery.json")
    print("Saved:", directory / "delivery.json")
    print("Usage:", delivery.get("usage"))


if __name__ == "__main__":
    try:
        main()
    except (IndexError, KeyError, OSError, ValueError, requests.RequestException) as error:
        print("Network request failed. Keep this attempt and inspect its saved files."
              if isinstance(error, requests.RequestException) else str(error), file=sys.stderr)
        sys.exit(1)
```

#### बचाया नौकरी की जाँच करें

```bash
python collect.py job-001
```


### Bash

#### download-video/collect.sh

```bash
#!/usr/bin/env bash
# Save as download-video/collect.sh.
set -euo pipefail
umask 077
cd -- "$(dirname -- "$0")"
folder=${1:?Usage: bash collect.sh job-001}
[[ "$folder" =~ ^[A-Za-z0-9_-]+$ ]] || exit 2
if [[ -f "$folder/delivery.json" ]]; then
  echo "Already saved: $folder/delivery.json"
  exit 0
fi
id=$(jq -er 'select(.source == "youtube_download") | .id
  | select(test("^[A-Za-z0-9_-]+$"))' "$folder/submission.json")
if [[ -z "${FLASHDATA_API_KEY:-}" ]]; then
  read -r -s -p 'FLASHDATA_API_KEY: ' FLASHDATA_API_KEY; printf '\n'
fi
: "${FLASHDATA_API_KEY:?Set your key}"
url="https://api.flashdata.dev/v2/jobs/$id"
status=$(curl --silent --show-error --connect-timeout 10 --max-time 120 \
  --header "X-API-Key: $FLASHDATA_API_KEY" --header 'Accept: application/json' \
  --dump-header "$folder/job-status.json.headers" --output "$folder/job-status.json" \
  --write-out '%{http_code}' "$url")
printf '%s' "$status" > "$folder/job-status.json.http"
[[ "$status" == 200 ]] || { echo "HTTP $status. Inspect job-status.json and its headers." >&2; exit 1; }
state=$(jq -er --arg id "$id" 'select(.job.id == $id and .job.source == "youtube_download")
  | .job.status' "$folder/job-status.json")
case "$state" in
  pending|processing) echo "$state. Wait 10 seconds, then run this command again."; exit 0 ;;
  completed) ;;
  *) echo "Job $state. Inspect job-status.json; do not resubmit." >&2; exit 1 ;;
esac
status=$(curl --silent --show-error --connect-timeout 10 --max-time 120 \
  --header "X-API-Key: $FLASHDATA_API_KEY" --header 'Accept: application/json' \
  --dump-header "$folder/result-headers.txt" --output "$folder/delivery.pending.json" \
  --write-out '%{http_code}' "$url/results")
printf '%s' "$status" > "$folder/result-http.txt"
if [[ "$status" == 302 ]]; then
  location=$(awk 'tolower($1)=="location:" {sub(/\r$/, "", $2); print $2}' "$folder/result-headers.txt")
  [[ "$location" =~ ^https://[^/@[:space:]]+(/|$) ]] || { echo 'Expected an HTTPS result URL.' >&2; exit 1; }
  # Retrieve the JSON delivery record without the FlashData key. Do not add -L.
  status=$(curl --silent --show-error --compressed --proto '=https' \
    --connect-timeout 10 --max-time 120 --dump-header "$folder/storage-result-headers.txt" \
    --output "$folder/delivery.pending.json" --write-out '%{http_code}' "$location")
  printf '%s' "$status" > "$folder/storage-result-http.txt"
fi
[[ "$status" == 200 ]] || { echo "HTTP $status. Resolve the error, then run collect.sh again." >&2; exit 1; }
jq -e '.source == "youtube_download" and .status == "done"
  and (.results | type == "array" and length == 1)' "$folder/delivery.pending.json" >/dev/null
mv "$folder/delivery.pending.json" "$folder/delivery.json"
echo "Saved: $folder/delivery.json"
jq '{usage}' "$folder/delivery.json"
```

#### बचाया नौकरी की जाँच करें

```bash
bash collect.sh job-001
```


- [नौकरी की स्थिति और परिणाम पुनर्प्राप्ति](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md)

<a id="output"></a>

### क्या delivery.json में शामिल हैं

परिणाम में file_url, file_size, बाइट्स और md5 शामिल हैं। उपयोग में पूरा काम पूरा होने का आरोप है। पूरा रिकॉर्ड रखें। फ़ाइल URL अपने S3 वस्तु का नाम है; यह सार्वजनिक रूप से पठनीय नहीं है।

#### job-001/delivery.json · illustrative फ़ील्ड

```json
{
  "source": "youtube_download",
  "status": "done",
  "results": [
    {
      "file_url": "https://your-media-bucket.s3.us-east-1.amazonaws.com/recipes/clip-001/jNQXAC9IVRw.mp4",
      "file_size": 1048576,
      "md5": "0123456789abcdef0123456789abcdef"
    }
  ]
}
```


<a id="verify"></a>

## 4. निजी ऑब्जेक्ट को पढ़ें और इसे सत्यापित करें

अन्य लिपियों के बगल में सत्यापन स्क्रिप्ट सहेजें। ऑब्जेक्ट तक पहुंच पढ़ने के साथ अपनी कॉन्फ़िगर स्थानीय AWS पहचान का उपयोग करें। स्क्रिप्ट यह जांचती है कि वितरण योजनाबद्ध S3 बाल्टी, उपसर्ग और वीडियो फ़ाइल नाम से संबंधित है, फिर इसे media.mp4.part पर डाउनलोड करें।

केवल एक मिलान बाइट गिनती और MD5 media.mp4 और verified.json का उत्पादन करता है। फिर से चल रहा सत्यापन स्थानीय रूप से एक मौजूदा media.mp4 की जाँच करता है। यह कदम आपके S3 ऑब्जेक्ट को पढ़ता है; यह एक अन्य FlashData डाउनलोड को प्रस्तुत नहीं करता है।

### Python

#### download-video/verify.py

```python
# Save as download-video/verify.py, beside submit.py.
import hashlib
import json
import os
import re
import sys
from contextlib import closing
from datetime import datetime, timezone
from urllib.parse import urlsplit

import boto3
from submit import ROOT, read_json


def main():
    os.umask(0o077)
    folder = sys.argv[1]
    if not re.fullmatch(r"[A-Za-z0-9_-]+", folder):
        raise ValueError("Use the saved output folder name.")
    directory = ROOT / folder
    request = read_json(directory / "request.json")
    receipt = read_json(directory / "submission.json")
    job = read_json(directory / "job-status.json")["job"]
    delivery = read_json(directory / "delivery.json")
    if (request["source"] != "youtube_download" or receipt["source"] != "youtube_download"
            or job["id"] != receipt["id"] or job["source"] != "youtube_download"
            or job["status"] != "completed" or delivery.get("source") != "youtube_download"
            or delivery.get("status") != "done" or len(delivery["results"]) != 1):
        raise ValueError("Check the saved request, receipt, status and delivery.")
    storage = request["params"]["storage"]
    bucket, region, prefix = (storage[k] for k in ("storage_url", "region", "object_prefix"))
    file = delivery["results"][0]
    parsed = urlsplit(file["file_url"])
    # This recipe uses an ASCII prefix and the MP4 filename generated for the video.
    object_key = prefix + "/" + request["video_id"] + ".mp4"
    if (storage["storage_type"] != "s3" or parsed.scheme != "https"
            or parsed.netloc != bucket + ".s3." + region + ".amazonaws.com"
            or parsed.path != "/" + object_key or parsed.query or parsed.fragment
            or type(file.get("file_size")) is not int or file["file_size"] <= 0
            or not re.fullmatch(r"[A-Fa-f0-9]{32}", file.get("md5", ""))):
        raise ValueError("Delivery URL, byte count or MD5 does not match this recipe's request.")
    local = directory / "media.mp4"
    pending = directory / "media.mp4.part"
    if not local.exists():
        # Boto3 uses your local AWS read identity, not the upload key sent to FlashData.
        with pending.open("xb") as output:
            s3 = boto3.client("s3", region_name=region)
            with closing(s3.get_object(Bucket=bucket, Key=object_key)["Body"]) as stream:
                while chunk := stream.read(1024 * 1024):
                    output.write(chunk)
        local = pending
    size, digest = 0, hashlib.md5(usedforsecurity=False)
    with local.open("rb") as stream:
        while chunk := stream.read(1024 * 1024):
            size += len(chunk)
            digest.update(chunk)
    if size != file["file_size"] or digest.hexdigest() != file["md5"].lower():
        raise ValueError("Size or MD5 mismatch. Keep the local file for inspection.")
    final = directory / "media.mp4"
    if local == pending:
        pending.rename(final)
    record = {
        "job_id": receipt["id"], "video_id": request["video_id"],
        "bucket": bucket, "object_key": object_key, "bytes": size, "md5": digest.hexdigest(),
        "verified_at": datetime.now(timezone.utc).isoformat(), "usage": delivery.get("usage"),
    }
    (directory / "verified.json").write_text(json.dumps(record, indent=2), encoding="utf-8")
    print("Verified:", final, "—", size, "bytes; MD5 matches.")


if __name__ == "__main__":
    try:
        main()
    except Exception as error:
        print(str(error), file=sys.stderr)
        sys.exit(1)
```

#### सेव्ड डिलीवरी को सत्यापित करें

```bash
python verify.py job-001
```


### Bash

#### download-video/verify.sh

```bash
#!/usr/bin/env bash
# Save as download-video/verify.sh.
set -euo pipefail
umask 077
cd -- "$(dirname -- "$0")"
folder=${1:?Usage: bash verify.sh job-001}
[[ "$folder" =~ ^[A-Za-z0-9_-]+$ ]] || exit 2
jq -e --slurpfile r "$folder/request.json" --slurpfile s "$folder/submission.json" \
  --slurpfile j "$folder/job-status.json" '
  $r[0] as $r | $s[0] as $s | $j[0].job as $j
  | $r.params.storage as $store
  | ($store.object_prefix + "/" + $r.video_id + ".mp4") as $key
  | .results[0] as $f
  | $r.source == "youtube_download" and $s.source == "youtube_download"
    and $j.id == $s.id and $j.source == "youtube_download" and $j.status == "completed"
    and .source == "youtube_download" and .status == "done"
    and (.results | type == "array" and length == 1)
    and $store.storage_type == "s3"
    and $f.file_url == ("https://" + $store.storage_url + ".s3." + $store.region + ".amazonaws.com/" + $key)
    and ($f.file_size | type == "number" and . > 0 and . == floor)
    and ($f.md5 | test("^[A-Fa-f0-9]{32}$"))
' "$folder/delivery.json" >/dev/null
bucket=$(jq -er '.params.storage.storage_url' "$folder/request.json")
region=$(jq -er '.params.storage.region' "$folder/request.json")
key=$(jq -er '.params.storage.object_prefix + "/" + .video_id + ".mp4"' "$folder/request.json")
local_file="$folder/media.mp4"
if [[ ! -e "$local_file" ]]; then
  local_file="$folder/media.mp4.part"
  [[ ! -e "$local_file" ]] || { echo 'Keep the partial file; inspect it before retrying.' >&2; exit 1; }
  # AWS CLI uses your configured read identity; no FlashData key is sent to S3.
  aws s3 cp "s3://$bucket/$key" "$local_file" --region "$region" --only-show-errors
fi
bytes=$(wc -c < "$local_file" | tr -d '[:space:]')
md5=$(openssl dgst -md5 "$local_file" | awk '{print tolower($NF)}')
expected_bytes=$(jq -er '.results[0].file_size' "$folder/delivery.json")
expected_md5=$(jq -er '.results[0].md5 | ascii_downcase' "$folder/delivery.json")
[[ "$bytes" == "$expected_bytes" && "$md5" == "$expected_md5" ]] ||
  { echo 'Size or MD5 mismatch. Keep the local file for inspection.' >&2; exit 1; }
if [[ "$local_file" != "$folder/media.mp4" ]]; then
  mv "$local_file" "$folder/media.mp4"
fi
jq --slurpfile r "$folder/request.json" --slurpfile s "$folder/submission.json" \
  --arg key "$key" --arg md5 "$md5" --argjson bytes "$bytes" '
  {job_id: $s[0].id, video_id: $r[0].video_id, bucket: $r[0].params.storage.storage_url,
   object_key: $key, bytes: $bytes, md5: $md5, verified_at: (now | todateiso8601), usage}
' "$folder/delivery.json" > "$folder/verified.json"
echo "Verified: $folder/media.mp4 — $bytes bytes; MD5 matches."
```

#### सेव्ड डिलीवरी को सत्यापित करें

```bash
bash verify.sh job-001
```



<a id="files"></a>

### सफल परिणाम

ऊपर बाइट की गिनती स्पष्ट है। अब आपके पास अपनी बाल्टी में MP4 है, एक सत्यापित स्थानीय प्रतिलिपि है, और verified.json अपनी नौकरी ID, वीडियो ID, ऑब्जेक्ट कुंजी, चेकसूम और रिपोर्ट के उपयोग के लिए फाइल को टाइप करते हैं।

#### टर्मिनल

```text
Verified: .../job-001/media.mp4 — 1048576 bytes; MD5 matches.
```


<a id="recover"></a>

## एक सेकंड के डाउनलोड के बिना फिर से शुरू

| क्या हुआ | अगली कार्रवाई |
| --- | --- |
| जमा करने का समय या कोई नौकरी नहीं ID बचाया गया था | कार्य-001 रखें और अपने टाइमस्टैम्प और वीडियो का उपयोग करके History को चेक करें। फ़ोल्डर को दूसरे सबमिशन को मजबूर करने के लिए न हटाएं। यह तय करने से पहले कि क्या एक नया अनुरोध आवश्यक है, मूल नौकरी को पुनर्प्राप्त करें। |
| लंबित / प्रसंस्करण | प्रतीक्षा करें 10 सेकंड, फिर नौकरी-001 के साथ फिर से इकट्ठा होता है। यह केवल मौजूदा नौकरी पढ़ता है। |
| नौकरी विफल | त्रुटि के लिए job-status.json का निरीक्षण करें। स्पष्ट रूप से एक नए फ़ोल्डर और उपसर्ग में एक नया काम शुरू करने से पहले वीडियो या स्टोरेज कॉन्फ़िगरेशन को ठीक करें। |
| 401 / 403 / 402 / 429 | कुंजी, अनुमति या शेष राशि की जाँच करें। 429 के लिए, बचाया हेडर में Retry-After पढ़ा और प्रतीक्षा करें। स्क्रिप्ट स्वचालित रूप से प्रस्तुतीकरण नहीं करते हैं। |
| परिणाम असफल हो गया या उसके हस्ताक्षरित URL समाप्त हो गया | फिर से मौजूदा परिणाम का अनुरोध करने के लिए Rerun जॉब-001 के लिए इकट्ठा होता है। |
| S3 AccessDenied | स्थानीय एडब्ल्यूएस की पहचान या बाल्टी नीति को ठीक करें। FlashData अपलोड एक्सेस और स्थानीय पढ़ने की सुविधा अलग है। |
| आंशिक फ़ाइल, गलत पथ, बाइट गिनती या MD5 | निरीक्षण के लिए सहेजे गए वितरण और फ़ाइल को रखें। एक ताजा S3 के लिए कारण को हल करने के बाद पढ़ा गया, media.mp4.part को एक तरफ ले जाने के बाद फिर से सत्यापित हो गया। प्रस्तुत न करें। |

- [अनुरोध इतिहास](https://flashdata.dev/app/jobs)
- [विकल्प और भंडारण प्रदाता डाउनलोड करें](https://flashdata.dev/hi/docs/sources/youtube_download/reference.md)
- [मीडिया वितरण पाइपलाइन का निर्माण](https://flashdata.dev/hi/docs/guides/media-delivery-pipeline/reference.md)
