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