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

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

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

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

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

Για να εξηγήσει τον κεντρικό υπολογιστή API, το EasyF διαχωρίζει τα διαπιστευτήρια ενεργοποιημένα από την υποστήριξη από ένα εκχωρημένο σημείο τερματικού ενοικιαστή. Μια ροή εργασίας σε απλή γλώσσα δίνει σε μια κλήση μόνο διακομιστή τη δική της θέση.

Διεύθυνση URL μισθωτήhttps://easyf.app

Έλεγχος ταυτότηταςX-API-Key: pending_activation_…

Προφίλ του πελάτηEasyfClient

Έκδοση APIv1

# Available only after support activation
export EASYF_SERVICE_KEY="issued-after-review"

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

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

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

Για να εξηγήσουμε τη λειτουργία Resolve, το EasyF διαχωρίζει την ανίχνευση πηγής από μορφές από μία υποβληθείσα διεύθυνση Μια ροή εργασίας σε απλή γλώσσα δεν δίνει σε καμία εφευρεμένη έξοδο τη δική της θέση.

ΤΑΧΥΔΡΟΜΙΚΗ ΥΠΗΡΕΣΙΑ/v1/resolveΠεδίο εφαρμογής: επιλύστε

Πεδίο	Τύπος	Απαιτείται	Περιγραφή
`asset_url`	Διεύθυνση HTTPS	Ναι	Δημόσια ή εξουσιοδοτημένη σελίδα μέσων ενημέρωσης για ανάλυση.
`tenant`	συμβολοσειρά	Όχι.	Τομέας εκχωρημένου μισθωτή. Συνήθως παραλείπεται.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Ο αναγνωριστικός κωδικός μορφής ξεκινά με την επιστρεφόμενη τιμή αμετάβλητη στο EasyF. Η επόμενη προβολή καλύπτει τη διαθεσιμότητα ανά σύνδεσμο. Η σελίδα δεν διατηρεί ορατή καμία ετικέτα υποθετικής ποιότητας.

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

Το EasyF παρουσιάζει τρία πρακτικά σημεία για τη δημιουργία Εργασίας. Πρώτα έρχεται η ασύγχρονη προετοιμασία. Η ροή εργασίας σε απλή γλώσσα καλύπτει στη συνέχεια ένα σύντομο αίτημα HTTP. Το τελικό σημείο είναι η περιορισμένη εκτέλεση εργαζομένου.

ΤΑΧΥΔΡΟΜΙΚΗ ΥΠΗΡΕΣΙΑ/v1/jobsΠεδίο εφαρμογής: θέσεις εργασίας

Πεδίο	Τύπος	Απαιτείται	Περιγραφή
`asset_url`	Διεύθυνση HTTPS	Ναι	Η ίδια κανονικοποιημένη πηγή που υποβλήθηκε για να επιλυθεί.
`variant_code`	συμβολοσειρά	Ναι	Ένα ακριβές αναγνωριστικό από την απόκριση επίλυσης.
`tenant`	συμβολοσειρά	Όχι.	Τομέας εκχωρημένου μισθωτή. Συνήθως παραλείπεται.

curl -X POST https://easyf.app/v1/jobs \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'

1202 ΑποδεκτέςΑποθήκευση delivery_id.

2Κατάσταση δημοσκόπησηςGET /v1/jobs/{delivery_id} με το ίδιο κλειδί.

3ΈτοιμοςΑνοίξτε τη διεύθυνση λήψης με υπογραφή.

Κατάσταση	Σημασία	Ενέργεια πελάτη
`queued`	Εισήχθη στην οριοθετημένη ουρά.	Δημοσκόπηση ξανά με backoff.
`extracting`	Ανανέωση μεταδεδομένων προέλευσης ή διαδρομής.	Συνεχίστε την ψηφοφορία.
`processing`	Κατέβασμα, αναμίξη ή συγχώνευση.	Εμφάνιση προόδου διακομιστή.
`ready`	Υπογραφή λήψης είναι διαθέσιμη.	Στείλτε τη διεύθυνση στο χρήστη.
`failed`	Τερματικό δομημένο σφάλμα.	Διαβάστε `error_code`. Επαναλάβετε μόνο όταν συμβουλεύεται.
`expired`	Η προσωρινή έξοδος αφαιρέθηκε.	Δημιουργήστε μια νέα εργασία.

curl https://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

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

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

Το EasyF οργανώνει το συμβόλαιο σφάλματος γύρω από έναν φάκελο μη 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.

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

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

Χρησιμοποιήστε λογική idempotent εφαρμογής και ποτέ δεν ξεκινούν διπλότυπες εργασίες για το ίδιο κλικ χρήστη.
Η προσωρινή μνήμη επιλύει τα μεταδεδομένα σύντομα, αλλά πάντα αντιμετωπίζει τις υπογεγραμμένες διευθύνσεις λήψης ως λήγουσες.
Χρησιμοποιήστε περιορισμένο εκθετικό backoff με jitter για 429, 503 και επαναληπτέα λάθη.
Επεξεργαστείτε μόνο δημόσια μέσα ή μέσα στα οποία έχετε εξουσιοδότηση πρόσβασης.Δεν παρακάμπτονται οι έλεγχοι και οι έλεγχοι πρόσβασης.
Διατηρήστε τα αναγνωριστικά αιτημάτων και τα αναγνωριστικά εργασιών σε ιδιωτικά λειτουργικά αρχεία καταγραφής.Μην καταγράφετε τις υποβληθείσες διευθύνσεις χωρίς λόγο.

Για να εξηγήσουμε την πρόσβαση στο Σχήμα, το EasyF διαχωρίζει την ενεργοποίηση πριν την εξερεύνηση από την εκχωρημένη αυθεντικοποίηση. Μια ροή εργασίας σε απλή γλώσσα δίνει στα τεκμηριωμένα σχήματα αιτήσεων τη δική τους θέση.

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

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

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

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