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