ข้ามไปยังเนื้อหา
TH
รับคีย์ API
เรียกดูเอกสาร

เอกสารอ้างอิง API

YouTube Trainability API

รับคีย์ API

เช็ค YouTube ใบอนุญาตของวิดีโอสําหรับป้ายงานสร้างสรรค์คอมมอนส์ และรับผลที่ออกมา JSON.

สร้างคำขอ

เดอะ 11- ช่างทําเล็บ ID จากวีดีโอ URLไม่เต็ม URL.

POSThttps://data.flashdata.dev/v1/queries/realtime
Python 3 · requests
python3 -m pip install requests
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_trainability",
    "video_id": "dQw4w9WgXcQ",
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key, "Accept": "application/json"},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
ผลในการตอบสนอง HTTPX-API-Key ยืนยัน

พารามิเตอร์

ส่ง source ถึง video_id ที่ระดับบนสุด แหล่งที่มานี้ไม่มี พารัมที่ระบุแหล่ง ช่องข้อมูลทางเลือกสามารถยกเลิกได้

เนื้อหาคำขอ

sourcestring / จำเป็น
กําหนดเป็น youtube_trainability
video_idstring / จำเป็น
เดอะ 11- ช่างทําเล็บ YouTube วิดีโอ IDเช่น FUFGCZ092b0. รับจดหมาย ตัวเลข อุปทาน และไฮเฟน
ตรงกับ 11 ตัวอักษรค่าปริยาย: ยังไม่ได้ตั้งค่า
รูปแบบที่ยอมรับได้^[A-Za-z0-9_-]{11}$
callback_urlstring · nullable / ไม่บังคับ
Async และชุดเท่านั้น สาธารณะ HTTPS เสร็จสมบูรณ์แล้ว URL บนพอร์ต 443ถึง 2,048 ตัวละคร ไม่มีเอกสารรับรองผู้ใช้หรือส่วน URL Omit, ใช้ null หรือข้อความเปล่าสําหรับไม่ให้แจ้งเตือน ในชุดนี้ กําหนดให้แต่ละคําถาม ภายนอกพม่า
ค่าปริยาย: ยังไม่ได้ตั้งค่า

คำตอบ

Realtime กลับค่า status: done. อ่านผลลัพธ์ที่ส่งมาจากแหล่ง results[0].permitted; usage.credits บันทึกค่าใช้จ่าย.

ผล ที่ ตาม มา videoId และรายงานด้วย อนุมัติและอนุญาต [ผู้ทํางานตรวจสอบป้ายใบอนุญาตของวิดีโอ: ["all"สําหรับการตรวจสอบป้ายงานสร้างสรรค์คอมมอนส์ ไม่งั้น"none"] รวมถึงข้อมูลใบอนุญาตหายด้วย

อ่านผลที่ออกมา

บันทึกความสําเร็จ JSON ตอบกลับเป็น response.json. บันทึกนี้เป็น read-response.py และเรียกไพธอน read-response.py. มันใช้เฉพาะ Pythonห้องสมุดมาตรฐาน และไม่มีการร้องขอใหม่

read-response.py
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = {"videoId": result.get("videoId"), "permitted": result.get("permitted", [])}
# Keep the label values; this is not a training-rights authorization.
print(json.dumps(output, ensure_ascii=False, indent=2))

แหล่งที่มานี้ไม่มีทางเลือกที่ระบุแหล่ง ส่ง video_id ที่ระดับบนสุด; param เลื่อน

จุดปลายนี้ไม่ได้รับข้อมูลผู้สร้าง YouTube การตั้งค่าการฝึกซ้อมระดับสาม ไม่อนุญาตสิทธิ์ในการอบรม ช่องข้อมูลนี้เป็นเพียงผลลัพธ์ของการตรวจสอบใบรับรองเท่านั้น

ช่องข้อมูลทั้งหมด
ช่องข้อมูลคําอธิบาย
sourcestringสิ่งที่ร้องขอมา API แหล่งข่าว
statusstringเสร็จสิ้นเมื่อการร้องขอจริง สําเร็จ
created_atstringช่วงเวลาการสร้างแบบ ISO 8601
usage.creditsnumberบัตรเครดิตตามที่ขอ จากแผนของคุณ
results[0].videoIdstringรายการที่ขอมาคือ ID
results[0].kindstringFlashData ชนิดของผลลัพธ์: Youtube#videoTrainability.
results[0].etagstringวิดีโอ ID สะท้อนเป็นแท็กตอบรับ
results[0].permittedarray<string>["all") เมื่อตรวจพบป้ายงานสร้างสรรค์คอมมอนส์ มิฉะนั้น (ค.ศ."none"สืบค้นเมื่อใบอนุญาตหายไป ค่าเหล่านี้ไม่รายงานผู้สร้าง YouTube การตั้งค่าการฝึกซ้อมระดับสาม

ช่องข้อมูลด้านบน จะใช้อธิบายค่าปริยาย JSON ตอบสนอง JSONข้อความธรรมดาและ Markdown รูปแบบ.

Async คืนค่าเป็นใบเสร็จงานหนึ่งตัว; จํานวนครั้งจะคืนค่ากลับมาเป็นหนึ่งตัว วิดีโอ ID. โปรดตรวจสอบสถานะงานพิมพ์แต่ละงาน และรับผลของมันโดยใช้ที่อยู่เชื่อมโยงที่ส่งกลับ

Async วงจรชีวิตแบบชุด

การรับช่วงนําใบเสร็จกลับมา ไม่ใช่ผลลัพธ์ Async สร้างงานหนึ่งงาน; กลุ่มต่าง ๆ จะคืนค่ากลับมาเป็นงานที่แยกไว้ queries[] สําหรับทุก ๆ คนที่สอบถามเจ้า ติดตามและรับงานแต่ละงานเป็นอิสระ

ส่งข้อมูลไปยัง data.flashdata.dev; สืบค้นสถานะงานและผลลัพธ์จาก api.flashdata.dev กับ X-API-Key แบบเดียวกัน ความ เกี่ยว พัน API ตัวอย่างพื้นฐานที่ใช้ Python ถึง cURL.

  1. 1. บันทึกงาน IDs

    เก็บรายการที่ต้องการของแหล่งนี้เมื่อสลับไปยัง Async สําหรับ Batchใส่การร้องขอแต่ละในลําดับของ JSON วัตถุ บันทึกงานที่ส่งกลับทั้งหมด ID

    Async ร้องขอและใบเสร็จ · Batch ต้องการตัวบุคคล

  2. 2. ตรวจสอบสถานะ

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: โพลด้วยความล่าช้าและความเคารพ Retry-After เมื่อถึงวันนี้ completed: รับผล failed: สืบค้นเมื่อ job.error.

    อ่าน job.status ไม่ใช่สถานะใบเสร็จรับส่ง

    ตรวจสอบสถานะที่: Python ถึง cURL

    สถานะงาน API อ้างอิง
  3. 3. ดึงข้อมูลผลลัพธ์

    GET https://api.flashdata.dev/v2/jobs/{jobId}/results

    หลังจากเติมให้สมบูรณ์แล้ว ให้ยืนยันการอ่านผลที่อ่านแล้ว 302 คลังสื่อ URL # หากไม่มีเธอ # API กุญแจ บันทึก JSON ภายใน 24 ชั่วโมงของการเติมให้สมบูรณ์

    ดึงข้อมูลผลลัพธ์ที่ออกมา Python ถึง cURL · รูปแบบคำตอบ

    ดาวน์โหลดผลลัพธ์ API อ้างอิง

การ สํารวจ และ ได้ ผล ที่ มี อยู่ แล้ว ไม่ ได้ ใช้ เงิน เครดิต ที่ สอบ ถาม. จับเวลาแบบสํารวจไม่ได้ยกเลิกงาน: ให้ ID แทนการส่งงานที่ซ้ํากัน % 1 ไม่ถูกต้อง!.

Webhook เมื่อเสร็จสิ้น

บอกรับต่อคําค้น

ตั้งค่า callback_url ที่ระดับบนสุดของการร้องขอ Asinc หรือ ภายในแต่ละคําถาม ในชุดที่อยู่นอก params. ไม่มีความต้องการการแยกเว็บฮุค- regressing Realtime ร้องขอไม่ให้ส่งการเรียกกลับ

ใช้สาธารณะชน HTTPS URL บนพอร์ต 443. FlashDataPOSTS แจ้งเตือนสําหรับแต่ละงานพิมพ์ที่ไปถึง completed หรือ failed; เหตุการณ์ที่บรรจุลิงก์ ไม่ใช่ผลลัพธ์เอง

การยอมรับและตรวจสอบ

กลับค่า 2xx หลังจากยอมรับเหตุการณ์นั้น บิดเบี้ยวโดย delivery_id, ยังถูกส่งมาเป็น X-Delivery-Id. ไม่ ปฏิบัติ ตาม การ ชี้ นํา.

การส่งล้มเหลว การลองใหม่ด้วยการกลับแบบเอกซ์โปเนนเชียลขึ้นไป 8 พยายามรวมทั้งหมด และที่มากที่สุด 24 ชั่วโมงหลังจากเติมให้สมบูรณ์แล้ว. ให้การวินิจฉัยเป็น การผิดพลาด

การเรียกตัวยังไม่แน่ชัด ยืนยันงาน IDแหล่งที่มาและสถานะปลายทางผ่าน สถานะที่ยืนยันแล้ว ก่อนที่จะประมวลผลการแจ้งเตือน การส่งมอบ ID สําหรับ deduction, ไม่ใช่ข้อพิสูจน์ของความเป็นจริง

ตัวอย่าง Hook เหตุการณ์และช่องข้อมูล
แจ้งเตือนการเติมให้สมบูรณ์
{
  "delivery_id": "completion:job_example0001",
  "id": "job_example0001",
  "source": "youtube_trainability",
  "status": "completed",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
      "method": "GET"
    }
  ]
}
ช่องข้อมูลคําอธิบาย
delivery_idstringเครื่องระบุการจัดส่งที่ทนทาน การแจ้งให้ทราบแบบย่อโดยใช้ค่านี้; มันถูกส่งมาใน X-Delivery-Id ส่วนหัว
idstringJoob ID.
sourcestringต้องการแหล่งข้อมูล
statusstringเสร็จสมบูรณ์หรือล้มเหลว
linksarrayสถานะและการเชื่อมโยงผลลัพธ์ การแจ้งให้ทราบไม่รวมเนื้อหาหรือรายการที่มีผล API กุญแจ
links[].relstringตัวตนหรือผลลัพธ์
links[].hrefstringการจัดการสัมบูรณ์ API URL2; ยืนยันตัวด้วย API กุญแจ
links[].methodstringGET.

สัญญาเว็บฮุคแบบเต็มและ URL จํากัด

ประมวลผลไฟล์แบบ Bulk

อัปโหลดหนึ่งวิดีโอ ID ต่อบรรทัดและสร้าง Bulk ทํางานกับแหล่ง: youtube_trainability. ตัวเลือกที่ใช้ร่วมกันจะถูกปรับใช้กับทุกแฟ้มคือ ID

แหล่งนี้ไม่มีตัวเลือกที่ระบุแหล่ง; ตั้งค่าแหล่งและอัปโหลดแฟ้ม ID

รับค่าสะสมที่สมบูรณ์เป็นรายการและบีบอัดข้อมูล gzip NDJSON ชิ้นส่วนผลลัพธ์ แหล่ง ข้อมูล ยัง สามารถ ส่ง ส่วน ต่าง ๆ ที่ ได้ จาก การ เก็บ เมฆ ของ คุณ ได้ ด้วย โดย การ วาง options.result_storage เมื่อสร้าง Bulk งาน เว้นแต่คํากล่าวที่รัดกุมชัดเจนเท่านั้น 24 หนึ่งชั่วโมงหลังจากทั้งหมด Bulk งานเสร็จสมบูรณ์แล้ว

Bulk การประมวลผล API · Python ถึง cURL · Batch JSON ต้องการ

สร้าง Bulk การ ไหล เวียน ของ แหล่ง นี้ · หยุดชั่วคราว และทําต่อและฟื้นตัว

การกู้คืนผิดพลาด

A ["none"ผลก็คือเช็คใบขับขี่เสร็จแล้ว ไม่ใช่งานล้มเหลว อาจหมายถึงไม่มีป้ายใบอนุญาติ วิดีโอที่ถูกลบออกหรือเข้าไม่ได้ อาจล้มเหลวในระหว่างการคลายข้อมูล

สําหรับการตรวจสอบสิทธิ์, ดุลยภาพ, ร้องขอunit-format และอัตราการสิ้นสุดของอัตรา - การอ้างอิงข้อผิดพลาดร่วมกัน เวลา ที่ ใช้ ไป แล้ว อาจ ยัง คง สร้าง งาน อยู่; ตรวจ สอบ งาน ที่ มี อยู่ ก่อน จะ ลอง ทํา ใหม่.

ข้อผิดพลาดและรหัสสถานะ · เมื่อต้องการลองใหม่ · ข้อจํากัดของอัตรา

ไกด์ทีละขั้น: ตีความป้ายใบอนุญาต

ราคา

แผนอัตราการใช้ต่อ 1,000 คำขอมาตรฐานสมาชิกรวมการให้เครดิตต่อช่วงเวลาเรียกเก็บเงิน
จ่ายตามการใช้งานUS$0.50ไม่มีค่าบริการรายเดือนเติมเครดิตเมื่อจำเป็น
MicroUS$0.40US$49.00 / เดือน1,000 เครดิต (Chonder)US$50.00 ของ API การใช้) รวม
StarterUS$0.35US$199.00 / เดือน4,000 เครดิต (Chonder)US$200.00 ของ API การใช้) รวม
ProUS$0.30US$499.00 / เดือน10,000 เครดิต (Chonder)US$500.00 ของ API การใช้) รวม
ScaleUS$0.25US$999.00 / เดือน20,000 เครดิต (Chonder)US$1,000.00 ของ API การใช้) รวม
BusinessUS$0.20US$1,999.00 / เดือน40,000 เครดิต (Chonder)US$2,000.00 ของ API การใช้) รวม

หนึ่งแผนต่อบัญชี ใช้เครดิตร่วมกันทั้งสามผลิตภัณฑ์ การใช้งานที่ครอบคลุมด้วยเครดิตในแผนจะไม่ถูกคิดค่าบริการซ้ำ

ราคาและแผนจํากัดในปัจจุบัน