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