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