Μόνο προεπισκόπηση — απαιτείται ενεργοποίηση

Κατασκευάστε λήψεις με QuickDL

Το QuickDL επιτρέπει στους προγραμματιστές να ελέγχουν το συμπαγές μοντέλο αιτήματος πριν από την ενεργοποίηση. Η υποστήριξη πρέπει να επικυρώσει το προϊόν πριν γίνει δυνατή η χρήση ιδιωτικού κλειδιού και ποσοστώσεων.

QuickDlJobsJSON μέσω HTTPSΑσύγχρονες θέσεις εργασίαςΔιαπιστευτήρια με εύρος
01

Γρήγορη έναρξη

Στο QuickDL, τα διαπιστευτήρια με ενεργοποιημένη υποστήριξη έρχονται πρώτα κατά την εξήγηση του API host. Αυτή η συμπαγής βοηθητική εφαρμογή ακολουθεί με ένα εκχωρημένο endpoint ενοικιαστή και κλείνει σε μια διαδρομή κλήσης μόνο για διακομιστή.

Διεύθυνση URL μισθωτήhttps://quickdl.app
Έλεγχος ταυτότηταςX-API-Key: pending_activation_…
Προφίλ του πελάτηQuickDlJobs
Έκδοση APIv1
# Available only after support activation
export QUICKDL_JOB_KEY="issued-after-review"

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

Το QuickDL διαχειρίζεται την ασφάλεια των διαπιστευτηρίων πρώτα εντοπίζοντας την αποθήκευση μυστικών στην πλευρά του διακομιστή. Ακολουθεί χωρίς ενσωμάτωση πακέτου πελάτη και δεν διατηρεί δημόσια αρχεία καταγραφής ή αποθετήρια σε θέα.

02

Επίλυση μιας σύνδεσης

Στο QuickDL, η ανίχνευση πηγής έρχεται πρώτη κατά την εξήγηση της λειτουργίας Resolve. Αυτή η συμπαγής χρησιμότητα ακολουθεί με μορφές από ένα υποβληθέν URL και κλείνει χωρίς εφευρεθείσες εξόδους.

ΤΑΧΥΔΡΟΜΙΚΗ ΥΠΗΡΕΣΙΑ/v1/resolveΠεδίο εφαρμογής: επιλύστε
ΠεδίοΤύποςΑπαιτείταιΠεριγραφή
public_linkΔιεύθυνση HTTPSΝαιΔημόσια ή εξουσιοδοτημένη σελίδα μέσων ενημέρωσης για ανάλυση.
tenantσυμβολοσειράΌχι.Τομέας εκχωρημένου μισθωτή. Συνήθως παραλείπεται.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Το QuickDL χειρίζεται τον αναγνωριστικό μορφής πρώτα αναγνωρίζοντας την επιστρεφόμενη τιμή αμετάβλητη. Ακολουθεί με διαθεσιμότητα ανά σύνδεσμο και δεν διατηρεί ετικέτα ποιότητας υπόθεση ορατή.

03

Δημιουργία και παρακολούθηση εργασίας λήψης

Η συμπαγής βοηθητική λειτουργία του QuickDL αναθεωρεί την ασύγχρονη προετοιμασία για τη δημιουργία εργασίας. Δείχνει ένα σύντομο αίτημα HTTP στη συνέχεια και δεν εμποδίζει την εκτέλεση δεσμευμένων εργαζομένων.

ΤΑΧΥΔΡΟΜΙΚΗ ΥΠΗΡΕΣΙΑ/v1/jobsΠεδίο εφαρμογής: θέσεις εργασίας
ΠεδίοΤύποςΑπαιτείταιΠεριγραφή
public_linkΔιεύθυνση HTTPSΝαιΗ ίδια κανονικοποιημένη πηγή που υποβλήθηκε για να επιλυθεί.
download_optionσυμβολοσειράΝαιΈνα ακριβές αναγνωριστικό από την απόκριση επίλυσης.
tenantσυμβολοσειράΌχι.Τομέας εκχωρημένου μισθωτή. Συνήθως παραλείπεται.
curl -X POST https://quickdl.app/v1/jobs \
  -H "X-API-Key: $QUICKDL_JOB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID","download_option":"18"}'
1202 ΑποδεκτέςΑποθήκευση quick_job.
2Κατάσταση δημοσκόπησηςGET /v1/jobs/{quick_job} με το ίδιο κλειδί.
3ΈτοιμοςΑνοίξτε τη διεύθυνση λήψης με υπογραφή.
ΚατάστασηΣημασίαΕνέργεια πελάτη
queuedΕισήχθη στην οριοθετημένη ουρά.Δημοσκόπηση ξανά με backoff.
extractingΑνανέωση μεταδεδομένων προέλευσης ή διαδρομής.Συνεχίστε την ψηφοφορία.
processingΚατέβασμα, αναμίξη ή συγχώνευση.Εμφάνιση προόδου διακομιστή.
readyΥπογραφή λήψης είναι διαθέσιμη.Στείλτε τη διεύθυνση στο χρήστη.
failedΤερματικό δομημένο σφάλμα.Διαβάστε error_code. Επαναλάβετε μόνο όταν συμβουλεύεται.
expiredΗ προσωρινή έξοδος αφαιρέθηκε.Δημιουργήστε μια νέα εργασία.
curl https://quickdl.app/v1/jobs/QUICK_JOB \
  -H "X-API-Key: $QUICKDL_JOB_KEY"

Το QuickDL παρουσιάζει τρία πρακτικά σημεία για την ψηφοφορία εργασίας. Πρώτα έρχεται η αρχική αναμονή ενός δευτερολέπτου. Η συμπαγής χρησιμότητα καλύπτει έπειτα το περιορισμένο backoff. Το τελικό σημείο του είναι προσωρινή υπογεγραμμένη παράδοση.

04

Προβλέψιμα λάθη

Το QuickDL προσεγγίζει το συμβόλαιο σφάλματος μέσω ενός φακέλου μη 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Μη έγκυρη διεύθυνση σώμα ή μη διαθέσιμη μορφή.Διορθώστε το αίτημα.Επιλύστε ξανά για μορφές.
401Κλειδί που λείπει, δεν είναι έγκυρο, έχει λήξει ή έχει λάθος εύρος.Ελέγξτε τα διαπιστευτήρια από την πλευρά του διακομιστή.
403Ο μισθωτής ή η πολιτική προέλευσης απέρριψε την αίτηση.Μην παρακάμψετε την πολιτική. Επικοινωνήστε με την υποστήριξη.
404Άγνωστη ή λήξασα εργασία.Δημιουργήστε μια νέα εργασία, εάν είναι απαραίτητο.
429Έχει επιτευχθεί το όριο αιτήματος ή ενεργών εργασιών.Τιμή retry_after_seconds.
503Ουρά/χωρητικότητα ή ανερχόμενη ροή προσωρινά μη διαθέσιμη.Ξαναπροσπάθησε με εκθετική υποχώρηση και jitter.
05

Σύμβαση λειτουργίας

Το QuickDL παρέχει μια συμπαγή, ειδική για τον πελάτη ποσόστωση που υποστηρίζει την ενσωμάτωση χωρίς να αποσταθεροποιεί τις υπηρεσίες προέλευσης.

Στο QuickDL, η ενεργοποίηση πριν την εξερεύνηση έρχεται πρώτη κατά την εξήγηση της πρόσβασης στο Σχήμα. Αυτή η συμπαγής βοηθητική εφαρμογή ακολουθεί με εκχωρημένη αυθεντικοποίηση και κλείνει σε τεκμηριωμένα σχήματα αιτήσεων.

ΠΡΟΣΒΑΣΗ ΠΟΥ ΕΛΕΓΧΕΤΑΙ ΑΠΟ ΤΟΝ ΧΕΙΡΙΣΤΗ

Ενεργοποίηση μέσω υποστήριξης

Παρέχετε στο QuickDL το όνομα ενσωμάτωσης, τον αναμενόμενο μηνιαίο όγκο και τις απαιτούμενες πηγές. Προσδιορίστε τις λειτουργίες που θα εκτελέσει ο διακομιστής ώστε η έγκριση να παράγει ένα στενά ορισμένο, μονομερές κλειδί.

Ζητήστε ενεργοποίηση Τα κλειδιά είναι περιορισμένα σε τομέα μισθωτή, ανακλητά και εκδίδονται μέσω της φόρμας Επικοινωνία.Ανώνυμες δέσμες ενεργειών δεν μπορούν να εκτελέσουν εργασίες λήψης.