ΠΑΡΑΓΩΓΗ REST API · v1

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

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

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

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

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

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

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

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

Έκδοση APIv1

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

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

Για να εξηγήσουμε την ασφάλεια διαπιστευτηρίων, το YTSave διαχωρίζει την αποθήκευση μυστικών στην πλευρά του διακομιστή από την μη ενσωμάτωση πακέτου πελάτη. Ένα αρχείο αποδεικτικών δεν δίνει δημόσια αρχεία καταγραφής ή αποθετήρια τη δική τους θέση.

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

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

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

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

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

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

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

Για τη δημιουργία Εργασίας, το YTSave ξεκινά με ασύγχρονη προετοιμασία. Το αρχείο αποδείξεων του συνδυάζει αυτό με ένα σύντομο αίτημα HTTP και τελειώνει με εκτέλεση περιορισμένου εργαζομένου.

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

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

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

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

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

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

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

curl https://ytsave.app/v1/jobs/JOB_ID \
  -H "X-API-Key: $YTSAVE_API_KEY"

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

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

Για το συμβόλαιο σφάλματος, το YTSave ελέγχει έναν φάκελο μη 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.

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

Το YTSave εκδίδει ένα λειτουργικό όριο με κάθε έγκριση για την προστασία του καταναλωτή API και των ανάντη υπηρεσιών μέσων.

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

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

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

Ζητήστε το κλειδί σας

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

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