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

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

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

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

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

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

Διεύθυνση URL μισθωτήhttps://savetk.app
Έλεγχος ταυτότηταςX-API-Key: pending_activation_…
Προφίλ του πελάτηSaveTkCreator
Έκδοση APIv1
# Available only after support activation
export SAVETK_CREATOR_KEY="issued-after-review"

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

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

02

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

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

ΤΑΧΥΔΡΟΜΙΚΗ ΥΠΗΡΕΣΙΑ/v1/resolveΠεδίο εφαρμογής: επιλύστε
ΠεδίοΤύποςΑπαιτείταιΠεριγραφή
creator_linkΔιεύθυνση HTTPSΝαιΔημόσια ή εξουσιοδοτημένη σελίδα μέσων ενημέρωσης για ανάλυση.
tenantσυμβολοσειράΌχι.Τομέας εκχωρημένου μισθωτή. Συνήθως παραλείπεται.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

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

03

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

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

ΤΑΧΥΔΡΟΜΙΚΗ ΥΠΗΡΕΣΙΑ/v1/jobsΠεδίο εφαρμογής: θέσεις εργασίας
ΠεδίοΤύποςΑπαιτείταιΠεριγραφή
creator_linkΔιεύθυνση HTTPSΝαιΗ ίδια κανονικοποιημένη πηγή που υποβλήθηκε για να επιλυθεί.
save_optionσυμβολοσειράΝαιΈνα ακριβές αναγνωριστικό από την απόκριση επίλυσης.
tenantσυμβολοσειράΌχι.Τομέας εκχωρημένου μισθωτή. Συνήθως παραλείπεται.
curl -X POST https://savetk.app/v1/jobs \
  -H "X-API-Key: $SAVETK_CREATOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_link":"https://www.youtube.com/watch?v=VIDEO_ID","save_option":"18"}'
1202 ΑποδεκτέςΑποθήκευση save_task.
2Κατάσταση δημοσκόπησηςGET /v1/jobs/{save_task} με το ίδιο κλειδί.
3ΈτοιμοςΑνοίξτε τη διεύθυνση λήψης με υπογραφή.
ΚατάστασηΣημασίαΕνέργεια πελάτη
queuedΕισήχθη στην οριοθετημένη ουρά.Δημοσκόπηση ξανά με backoff.
extractingΑνανέωση μεταδεδομένων προέλευσης ή διαδρομής.Συνεχίστε την ψηφοφορία.
processingΚατέβασμα, αναμίξη ή συγχώνευση.Εμφάνιση προόδου διακομιστή.
readyΥπογραφή λήψης είναι διαθέσιμη.Στείλτε τη διεύθυνση στο χρήστη.
failedΤερματικό δομημένο σφάλμα.Διαβάστε error_code. Επαναλάβετε μόνο όταν συμβουλεύεται.
expiredΗ προσωρινή έξοδος αφαιρέθηκε.Δημιουργήστε μια νέα εργασία.
curl https://savetk.app/v1/jobs/SAVE_TASK \
  -H "X-API-Key: $SAVETK_CREATOR_KEY"

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

04

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

Το συμβόλαιο σφάλματος ξεκινά με έναν φάκελο μη 2xx στο SaveTK. Η επόμενη προβολή καλύπτει ένα αναγνωριστικό αιτήματος υποστήριξης. Η σελίδα διατηρεί ορατή την προβλέψιμη διαχείριση πελάτη.

{
  "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.
05

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

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

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

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

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

Δηλώστε τι κάνει ο πελάτης SaveTK, πόσες κλήσεις αναμένει και ποιες υπηρεσίες ανάρτησης είναι απαραίτητες. Η ανασκόπηση υποστήριξης επιλέγει τα πεδία εφαρμογής της, στη συνέχεια επιστρέφει ένα μη ανακτήσιμο διαπιστευτήριο που εμφανίζεται μία φορά.

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