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