https://quickt.ioΚατασκευάστε λήψεις με QuickT
Ο QuickT τεκμηριώνει πώς ένας κινητός πελάτης θα επικοινωνούσε με την υπηρεσία. Δεν μπορεί να υποβάλει παραγωγική εργασία μέχρι να εγκρίνει η υποστήριξη το σχέδιο και να ενεργοποιήσει την περιορισμένη πρόσβαση.
Γρήγορη έναρξη
Για τον κεντρικό υπολογιστή API, το QuickT ελέγχει τα διαπιστευτήρια που έχουν ενεργοποιηθεί από την υποστήριξη πριν από ένα εκχωρημένο τελικό σημείο μισθωτή.Αυτή η προβολή έτοιμη για συσκευές καθιστά επίσης σαφή μια διαδρομή κλήσης μόνο διακομιστή.
X-API-Key: pending_activation_…QuicktRoutev1# Available only after support activation
export QUICKT_ROUTE_TOKEN="issued-after-review"
curl -X POST https://quickt.io/v1/resolve \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'Το QuickT οργανώνει την ασφάλεια των διαπιστευτηρίων γύρω από την αποθήκευση μυστικών στην πλευρά του διακομιστή. Η προβολή έτοιμη για συσκευή δεν συγκρίνει ενσωμάτωση πακέτου πελάτη. Δεν υπάρχουν δημόσια αρχεία καταγραφής ή αποθετήρια ως ο τελικός έλεγχος.
Επίλυση μιας σύνδεσης
Για τη λειτουργία Resolve, το QuickT ελέγχει την ανίχνευση πηγής πριν από τις μορφές από ένα υποβληθέν URL. Αυτή η προβολή έτοιμη για συσκευή επίσης καθιστά σαφή την απουσία εφευρεμένων εξόδων.
/v1/resolveΠεδίο εφαρμογής: επιλύστε| Πεδίο | Τύπος | Απαιτείται | Περιγραφή |
|---|---|---|---|
route_source | Διεύθυνση HTTPS | Ναι | Δημόσια ή εξουσιοδοτημένη σελίδα μέσων ενημέρωσης για ανάλυση. |
tenant | συμβολοσειρά | Όχι. | Τομέας εκχωρημένου μισθωτή. Συνήθως παραλείπεται. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}Το QuickT οργανώνει τον αναγνωριστικό μορφής γύρω από την επιστρεφόμενη τιμή χωρίς αλλαγές. Η προβολή έτοιμη για τη συσκευή συγκρίνει τη διαθεσιμότητα ανά σύνδεσμο. Καμία ετικέτα ποιότητας που έχει υποτεθεί δεν παραμένει ο τελικός έλεγχος.
Δημιουργία και παρακολούθηση εργασίας λήψης
Για να εξηγήσουμε τη Δημιουργία Εργασίας, το QuickT διαχωρίζει την ασύγχρονη προετοιμασία από ένα σύντομο αίτημα HTTP. Μια προβολή έτοιμη για συσκευή δίνει στην εκτέλεση περιορισμένων εργαζομένων τον δικό της χώρο.
/v1/jobsΠεδίο εφαρμογής: θέσεις εργασίας| Πεδίο | Τύπος | Απαιτείται | Περιγραφή |
|---|---|---|---|
route_source | Διεύθυνση HTTPS | Ναι | Η ίδια κανονικοποιημένη πηγή που υποβλήθηκε για να επιλυθεί. |
route_format | συμβολοσειρά | Ναι | Ένα ακριβές αναγνωριστικό από την απόκριση επίλυσης. |
tenant | συμβολοσειρά | Όχι. | Τομέας εκχωρημένου μισθωτή. Συνήθως παραλείπεται. |
curl -X POST https://quickt.io/v1/jobs \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID","route_format":"18"}'route_job.GET /v1/jobs/{route_job} με το ίδιο κλειδί.| Κατάσταση | Σημασία | Ενέργεια πελάτη |
|---|---|---|
queued | Εισήχθη στην οριοθετημένη ουρά. | Δημοσκόπηση ξανά με backoff. |
extracting | Ανανέωση μεταδεδομένων προέλευσης ή διαδρομής. | Συνεχίστε την ψηφοφορία. |
processing | Κατέβασμα, αναμίξη ή συγχώνευση. | Εμφάνιση προόδου διακομιστή. |
ready | Υπογραφή λήψης είναι διαθέσιμη. | Στείλτε τη διεύθυνση στο χρήστη. |
failed | Τερματικό δομημένο σφάλμα. | Διαβάστε error_code. Επαναλάβετε μόνο όταν συμβουλεύεται. |
expired | Η προσωρινή έξοδος αφαιρέθηκε. | Δημιουργήστε μια νέα εργασία. |
curl https://quickt.io/v1/jobs/ROUTE_JOB \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN"Η αρχική αναμονή ενός δευτερολέπτου είναι το σημείο εκκίνησης για την αναζήτηση εργασίας στο QuickT. Μια προβολή έτοιμη για τη συσκευή παρουσιάζει στη συνέχεια περιορισμένη απόσυρση και εξηγεί την προσωρινή υπογεγραμμένη παράδοση.
Προβλέψιμα λάθη
Για το συμβόλαιο Σφάλματος, το QuickT ξεκινά με έναν φάκελο μη 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. |
Σύμβαση λειτουργίας
Το QuickT επιλέγει όρια κινητού-πελάτη κατά την έγκριση, ώστε τα δίκτυα δημιουργών και το API να παραμένουν ανταποκρινόμενα.
- Χρησιμοποιήστε λογική idempotent εφαρμογής και ποτέ δεν ξεκινούν διπλότυπες εργασίες για το ίδιο κλικ χρήστη.
- Η προσωρινή μνήμη επιλύει τα μεταδεδομένα σύντομα, αλλά πάντα αντιμετωπίζει τις υπογεγραμμένες διευθύνσεις λήψης ως λήγουσες.
- Χρησιμοποιήστε περιορισμένο εκθετικό backoff με jitter για
429,503και επαναληπτέα λάθη. - Επεξεργαστείτε μόνο δημόσια μέσα ή μέσα στα οποία έχετε εξουσιοδότηση πρόσβασης.Δεν παρακάμπτονται οι έλεγχοι και οι έλεγχοι πρόσβασης.
- Διατηρήστε τα αναγνωριστικά αιτημάτων και τα αναγνωριστικά εργασιών σε ιδιωτικά λειτουργικά αρχεία καταγραφής.Μην καταγράφετε τις υποβληθείσες διευθύνσεις χωρίς λόγο.
Για πρόσβαση στο Σχήμα, το QuickT ελέγχει την ενεργοποίηση πριν από την εξερεύνηση και πριν από την εκχωρημένη αυθεντικοποίηση. Αυτή η προβολή έτοιμη για τη συσκευή καθιστά επίσης σαφή τα τεκμηριωμένα σχήματα αιτήσεων.
Ενεργοποίηση μέσω υποστήριξης
Περιγράψτε την εμπειρία για κινητά, την αναμενόμενη κίνηση και τα δίκτυα δημιουργών που χρειάζεται. Ο QuickT χρησιμοποιεί αυτές τις πληροφορίες για να αναθέσει ανάλυση και δικαιώματα ουράς πριν αποκαλύψει το μυστικό μία φορά.
Ζητήστε ενεργοποίηση Τα κλειδιά είναι περιορισμένα σε τομέα μισθωτή, ανακλητά και εκδίδονται μέσω της φόρμας Επικοινωνία.Ανώνυμες δέσμες ενεργειών δεν μπορούν να εκτελέσουν εργασίες λήψης.