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

Κατασκευάστε λήψεις με downf.io

Το DownF διατηρεί την εκτέλεση του API απενεργοποιημένη μέχρι να εξετάσει ένας χειριστής την περίπτωση χρήσης συμβατότητας. Τα παραδείγματα περιγράφουν το προγραμματισμένο συμβόλαιο, ενώ τα πραγματικά διαπιστευτήρια και τα όρια φτάνουν μόνο μέσω ενεργοποίησης υποστήριξης.

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

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

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

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

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

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

Έκδοση APIv1

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

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

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

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

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

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

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

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

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

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

Η δημιουργία εργασίας ξεκινά με ασύγχρονη προετοιμασία στο DownF. Η επόμενη προβολή καλύπτει ένα σύντομο αίτημα HTTP. Η σελίδα διατηρεί ορατή την εκτέλεση περιορισμένου εργαζομένου.

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

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

curl -X POST https://downf.io/v1/jobs \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID","output_ref":"18"}'

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

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

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

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

curl https://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

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

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

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

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

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

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

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

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

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

Περιγράψτε το προϊόν, προβλέψτε τις μηνιαίες κλήσεις του και καταγράψτε τις πλατφόρμες που πρέπει να αναλύσει. Η υποστήριξη του DownF θα επιβεβαιώσει τα απαιτούμενα πεδία πριν εκδώσει ένα ορατό διαπιστευτήριο μίας χρήσης του οποίου το αποθηκευμένο αντίγραφο είναι μόνο ένα hash.

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