https://insts.ioΔημιουργήστε λήψεις με το Insts
Ο πάγκος εργασίας Insts παρακάτω είναι τεκμηρίωση για έναν υποψήφιο πελάτη. Η ανασκόπηση από τον χειριστή προηγείται της δημιουργίας οποιουδήποτε εκτελέσιμου διαπιστευτηρίου ή άδειας κλήσης.
Γρήγορη έναρξη
Ο κεντρικός υπολογιστής API ξεκινά με διαπιστευτήρια ενεργοποιημένα από την υποστήριξη στο Insts. Η επόμενη προβολή καλύπτει ένα εκχωρημένο σημείο τερματισμού ενοικιαστή. Η σελίδα διατηρεί ορατή μια διαδρομή κλήσης μόνο για διακομιστή.
X-API-Key: pending_activation_…InstsConnectv1# Available only after support activation
export INSTS_CONNECT_SECRET="issued-after-review"
curl -X POST https://insts.io/v1/resolve \
-H "X-API-Key: $INSTS_CONNECT_SECRET" \
-H "Content-Type: application/json" \
-d '{"shared_post":"https://www.youtube.com/watch?v=VIDEO_ID"}'Η αποθήκευση μυστικών στην πλευρά του διακομιστή είναι το σημείο εκκίνησης για την ασφάλεια των διαπιστευτηρίων στο Insts. Ένα πάγκο επιθεώρησης στη συνέχεια δεν παρουσιάζει ενσωμάτωση πακέτου πελάτη και δεν εξηγεί δημόσια αρχεία καταγραφής ή αποθετήρια.
Επίλυση μιας σύνδεσης
Η λειτουργία επίλυσης ξεκινά με την ανίχνευση πηγής στο Insts. Η επόμενη προβολή καλύπτει μορφές από ένα υποβληθέν URL. Η σελίδα δεν διατηρεί ορατές εφευρεθείσες εξόδους.
/v1/resolveΠεδίο εφαρμογής: επιλύστε| Πεδίο | Τύπος | Απαιτείται | Περιγραφή |
|---|---|---|---|
shared_post | Διεύθυνση HTTPS | Ναι | Δημόσια ή εξουσιοδοτημένη σελίδα μέσων ενημέρωσης για ανάλυση. |
tenant | συμβολοσειρά | Όχι. | Τομέας εκχωρημένου μισθωτή. Συνήθως παραλείπεται. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}Η επιστρεφόμενη αμετάβλητη τιμή είναι το σημείο εκκίνησης για τον Αναγνωριστικό μορφής στο Insts. Ένα πάγκο επιθεώρησης παρουσιάζει στη συνέχεια τη διαθεσιμότητα ανά σύνδεσμο και εξηγεί την απουσία ετικέτας ποιότητας που έχει μαντευτεί.
Δημιουργία και παρακολούθηση εργασίας λήψης
Το Insts καθιστά τη δημιουργία Εργασίας εύκολη στην ανάλυση. Η σελίδα ξεκινά με ασύγχρονη προετοιμασία, προχωρά σε σύντομο αίτημα HTTP και δηλώνει σαφώς εκτέλεση περιορισμένου εργαζομένου.
/v1/jobsΠεδίο εφαρμογής: θέσεις εργασίας| Πεδίο | Τύπος | Απαιτείται | Περιγραφή |
|---|---|---|---|
shared_post | Διεύθυνση HTTPS | Ναι | Η ίδια κανονικοποιημένη πηγή που υποβλήθηκε για να επιλυθεί. |
asset_option | συμβολοσειρά | Ναι | Ένα ακριβές αναγνωριστικό από την απόκριση επίλυσης. |
tenant | συμβολοσειρά | Όχι. | Τομέας εκχωρημένου μισθωτή. Συνήθως παραλείπεται. |
curl -X POST https://insts.io/v1/jobs \
-H "X-API-Key: $INSTS_CONNECT_SECRET" \
-H "Content-Type: application/json" \
-d '{"shared_post":"https://www.youtube.com/watch?v=VIDEO_ID","asset_option":"18"}'connect_job.GET /v1/jobs/{connect_job} με το ίδιο κλειδί.| Κατάσταση | Σημασία | Ενέργεια πελάτη |
|---|---|---|
queued | Εισήχθη στην οριοθετημένη ουρά. | Δημοσκόπηση ξανά με backoff. |
extracting | Ανανέωση μεταδεδομένων προέλευσης ή διαδρομής. | Συνεχίστε την ψηφοφορία. |
processing | Κατέβασμα, αναμίξη ή συγχώνευση. | Εμφάνιση προόδου διακομιστή. |
ready | Υπογραφή λήψης είναι διαθέσιμη. | Στείλτε τη διεύθυνση στο χρήστη. |
failed | Τερματικό δομημένο σφάλμα. | Διαβάστε error_code. Επαναλάβετε μόνο όταν συμβουλεύεται. |
expired | Η προσωρινή έξοδος αφαιρέθηκε. | Δημιουργήστε μια νέα εργασία. |
curl https://insts.io/v1/jobs/CONNECT_JOB \
-H "X-API-Key: $INSTS_CONNECT_SECRET"Για την ανίχνευση εργασίας, το Insts ελέγχει μια αρχική αναμονή ενός δευτερολέπτου πριν από την περιορισμένη επανάληψη. Αυτό το σημείο επιθεώρησης καθιστά επίσης σαφή την προσωρινή υπογεγραμμένη παράδοση.
Προβλέψιμα λάθη
Το συμβόλαιο σφάλματος ξεκινά με έναν φάκελο μη 2xx στο Insts. Αυτός ο πάγκος επιθεώρησης παρουσιάζει στη συνέχεια ένα αναγνωριστικό αιτήματος υποστήριξης. Το τελικό γεγονός είναι η προβλέψιμη διαχείριση πελάτη.
{
"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. |
Σύμβαση λειτουργίας
Ο Insts καθορίζει όρια ρυθμού κατά τον χρόνο αναθεώρησης για να προστατεύσει τον χώρο εργασίας επιθεώρησης και κάθε διαδρομή παρόχου.
- Χρησιμοποιήστε λογική idempotent εφαρμογής και ποτέ δεν ξεκινούν διπλότυπες εργασίες για το ίδιο κλικ χρήστη.
- Η προσωρινή μνήμη επιλύει τα μεταδεδομένα σύντομα, αλλά πάντα αντιμετωπίζει τις υπογεγραμμένες διευθύνσεις λήψης ως λήγουσες.
- Χρησιμοποιήστε περιορισμένο εκθετικό backoff με jitter για
429,503και επαναληπτέα λάθη. - Επεξεργαστείτε μόνο δημόσια μέσα ή μέσα στα οποία έχετε εξουσιοδότηση πρόσβασης.Δεν παρακάμπτονται οι έλεγχοι και οι έλεγχοι πρόσβασης.
- Διατηρήστε τα αναγνωριστικά αιτημάτων και τα αναγνωριστικά εργασιών σε ιδιωτικά λειτουργικά αρχεία καταγραφής.Μην καταγράφετε τις υποβληθείσες διευθύνσεις χωρίς λόγο.
Η πρόσβαση στο σχήμα ξεκινά με ενεργοποίηση πριν από την εξερεύνηση στο Insts. Η επόμενη προβολή καλύπτει την εκχωρημένη αυθεντικοποίηση. Η σελίδα διατηρεί ορατά τα τεκμηριωμένα σχήματα αιτήσεων.
Ενεργοποίηση μέσω υποστήριξης
Μοιραστείτε το σενάριο χρήσης του πάγκου εργασίας, τον εκτιμώμενο αριθμό κλήσεων και τις υπηρεσίες υπό επιθεώρηση. Το Insts εξετάζει αυτό το όριο πριν εμφανιστεί μια διαπιστευτήρια ενοικιαστή μία φορά και μειωθεί σε αποθηκευμένο hash.
Ζητήστε ενεργοποίηση Τα κλειδιά είναι περιορισμένα σε τομέα μισθωτή, ανακλητά και εκδίδονται μέσω της φόρμας Επικοινωνία.Ανώνυμες δέσμες ενεργειών δεν μπορούν να εκτελέσουν εργασίες λήψης.