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

Δημιουργήστε λήψεις με το Insts

Ο πάγκος εργασίας Insts παρακάτω είναι τεκμηρίωση για έναν υποψήφιο πελάτη. Η ανασκόπηση από τον χειριστή προηγείται της δημιουργίας οποιουδήποτε εκτελέσιμου διαπιστευτηρίου ή άδειας κλήσης.

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

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

Ο κεντρικός υπολογιστής API ξεκινά με διαπιστευτήρια ενεργοποιημένα από την υποστήριξη στο Insts. Η επόμενη προβολή καλύπτει ένα εκχωρημένο σημείο τερματισμού ενοικιαστή. Η σελίδα διατηρεί ορατή μια διαδρομή κλήσης μόνο για διακομιστή.

Διεύθυνση URL μισθωτήhttps://insts.io
Έλεγχος ταυτότηταςX-API-Key: pending_activation_…
Προφίλ του πελάτηInstsConnect
Έκδοση APIv1
# 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. Ένα πάγκο επιθεώρησης στη συνέχεια δεν παρουσιάζει ενσωμάτωση πακέτου πελάτη και δεν εξηγεί δημόσια αρχεία καταγραφής ή αποθετήρια.

02

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

Η λειτουργία επίλυσης ξεκινά με την ανίχνευση πηγής στο 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. Ένα πάγκο επιθεώρησης παρουσιάζει στη συνέχεια τη διαθεσιμότητα ανά σύνδεσμο και εξηγεί την απουσία ετικέτας ποιότητας που έχει μαντευτεί.

03

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

Το 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"}'
1202 ΑποδεκτέςΑποθήκευση connect_job.
2Κατάσταση δημοσκόπησηςGET /v1/jobs/{connect_job} με το ίδιο κλειδί.
3ΈτοιμοςΑνοίξτε τη διεύθυνση λήψης με υπογραφή.
ΚατάστασηΣημασίαΕνέργεια πελάτη
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 ελέγχει μια αρχική αναμονή ενός δευτερολέπτου πριν από την περιορισμένη επανάληψη. Αυτό το σημείο επιθεώρησης καθιστά επίσης σαφή την προσωρινή υπογεγραμμένη παράδοση.

04

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

Το συμβόλαιο σφάλματος ξεκινά με έναν φάκελο μη 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.
05

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

Ο Insts καθορίζει όρια ρυθμού κατά τον χρόνο αναθεώρησης για να προστατεύσει τον χώρο εργασίας επιθεώρησης και κάθε διαδρομή παρόχου.

Η πρόσβαση στο σχήμα ξεκινά με ενεργοποίηση πριν από την εξερεύνηση στο Insts. Η επόμενη προβολή καλύπτει την εκχωρημένη αυθεντικοποίηση. Η σελίδα διατηρεί ορατά τα τεκμηριωμένα σχήματα αιτήσεων.

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

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

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

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