https://savetk.appΚατασκευάστε λήψεις με SaveTK
Το SaveTK εμφανίζει ένα σχέδιο API για ενσωματώσεις εργαλείων δημιουργού, αλλά δεν αποδέχεται μη αυθεντικοποιημένη εκτέλεση. Η έγκριση παρέχει τόσο το κλειδί όσο και τα όρια λειτουργίας του.
Γρήγορη έναρξη
Το SaveTK παρουσιάζει τρία πρακτικά σημεία για τον κεντρικό υπολογιστή API. Πρώτο έρχονται τα διαπιστευτήρια ενεργοποιημένα με υποστήριξη. Η ροή αποθήκευσης καλύπτει στη συνέχεια ένα εκχωρημένο σημείο τερματισμού ενοικιαστή. Το τελικό του σημείο είναι μια διαδρομή κλήσης μόνο για διακομιστή.
X-API-Key: pending_activation_…SaveTkCreatorv1# 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 καθιστά την ασφάλεια των Διαπιστευτηρίων εύκολη στην σάρωση. Η σελίδα ξεκινά με αποθήκευση μυστικών στην πλευρά του διακομιστή, προχωρά σε μη ενσωμάτωση πακέτου πελάτη και δηλώνει σαφώς ότι δεν υπάρχουν δημόσια αρχεία καταγραφής ή αποθετήρια.
Επίλυση μιας σύνδεσης
Το 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 καθιστά τον Αναγνωριστικό Μορφής εύκολο στην ανίχνευση. Η σελίδα ξεκινά με την επιστρεφόμενη τιμή αμετάβλητη, προχωρά στη διαθεσιμότητα ανά σύνδεσμο και δηλώνει σαφώς ότι δεν υπάρχει ετικέτα ποιότητας που να έχει υποτεθεί.
Δημιουργία και παρακολούθηση εργασίας λήψης
Η δημιουργία εργασίας ξεκινά με ασύγχρονη προετοιμασία στο 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"}'save_task.GET /v1/jobs/{save_task} με το ίδιο κλειδί.| Κατάσταση | Σημασία | Ενέργεια πελάτη |
|---|---|---|
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 χειρίζεται την αναζήτηση εργασίας προσδιορίζοντας πρώτα την αρχική αναμονή ενός δευτερολέπτου.Ακολουθεί με περιορισμένη οπισθοχώρηση και διατηρεί την προσωρινή υπογεγραμμένη παράδοση στο προσκήνιο.
Προβλέψιμα λάθη
Το συμβόλαιο σφάλματος ξεκινά με έναν φάκελο μη 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. |
Σύμβαση λειτουργίας
Το SaveTK ορίζει επιδόματα δημιουργού-ροής εργασίας μετά την εξέταση της αναμενόμενης επισκεψιμότητας και των πλατφορμών δημοσίευσης στο πεδίο εφαρμογής.
- Χρησιμοποιήστε λογική idempotent εφαρμογής και ποτέ δεν ξεκινούν διπλότυπες εργασίες για το ίδιο κλικ χρήστη.
- Η προσωρινή μνήμη επιλύει τα μεταδεδομένα σύντομα, αλλά πάντα αντιμετωπίζει τις υπογεγραμμένες διευθύνσεις λήψης ως λήγουσες.
- Χρησιμοποιήστε περιορισμένο εκθετικό backoff με jitter για
429,503και επαναληπτέα λάθη. - Επεξεργαστείτε μόνο δημόσια μέσα ή μέσα στα οποία έχετε εξουσιοδότηση πρόσβασης.Δεν παρακάμπτονται οι έλεγχοι και οι έλεγχοι πρόσβασης.
- Διατηρήστε τα αναγνωριστικά αιτημάτων και τα αναγνωριστικά εργασιών σε ιδιωτικά λειτουργικά αρχεία καταγραφής.Μην καταγράφετε τις υποβληθείσες διευθύνσεις χωρίς λόγο.
Το SaveTK παρουσιάζει τρία πρακτικά σημεία για την πρόσβαση στο Σχήμα. Πρώτα έρχεται η ενεργοποίηση πριν την εξερεύνηση. Η ροή αποθήκευσης καλύπτει στη συνέχεια την εκχωρημένη αυθεντικοποίηση. Το τελικό του σημείο είναι τα τεκμηριωμένα σχήματα αιτήσεων.
Ενεργοποίηση μέσω υποστήριξης
Δηλώστε τι κάνει ο πελάτης SaveTK, πόσες κλήσεις αναμένει και ποιες υπηρεσίες ανάρτησης είναι απαραίτητες. Η ανασκόπηση υποστήριξης επιλέγει τα πεδία εφαρμογής της, στη συνέχεια επιστρέφει ένα μη ανακτήσιμο διαπιστευτήριο που εμφανίζεται μία φορά.
Ζητήστε ενεργοποίηση Τα κλειδιά είναι περιορισμένα σε τομέα μισθωτή, ανακλητά και εκδίδονται μέσω της φόρμας Επικοινωνία.Ανώνυμες δέσμες ενεργειών δεν μπορούν να εκτελέσουν εργασίες λήψης.