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

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

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

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

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

Για τον κεντρικό υπολογιστή API, το Insto ξεκινά με διαπιστευτήρια ενεργοποιημένα από υποστήριξη. Η ανασκόπηση λήψης του το συνδυάζει με ένα εκχωρημένο σημείο τερματισμού ενοικιαστή και τελειώνει με μια διαδρομή κλήσης μόνο για διακομιστή.

Διεύθυνση URL μισθωτήhttps://insto.app

Έλεγχος ταυτότηταςX-API-Key: pending_activation_…

Προφίλ του πελάτηInstoMedia

Έκδοση APIv1

# Available only after support activation
export INSTO_MEDIA_TOKEN="issued-after-review"

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

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

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

Για τη λειτουργία Resolve, το Insto ξεκινά με ανίχνευση πηγής. Η ανασκόπηση λήψης του συνδυάζει αυτό με μορφές από ένα υποβληθέν URL και τελειώνει χωρίς εφευρεθείσες εξόδους.

ΤΑΧΥΔΡΟΜΙΚΗ ΥΠΗΡΕΣΙΑ/v1/resolveΠεδίο εφαρμογής: επιλύστε

Πεδίο	Τύπος	Απαιτείται	Περιγραφή
`media_source`	Διεύθυνση HTTPS	Ναι	Δημόσια ή εξουσιοδοτημένη σελίδα μέσων ενημέρωσης για ανάλυση.
`tenant`	συμβολοσειρά	Όχι.	Τομέας εκχωρημένου μισθωτή. Συνήθως παραλείπεται.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

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

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

Ο Insto οργανώνει τη δημιουργία εργασιών γύρω από την ασύγχρονη προετοιμασία. Η ανασκόπηση λήψης συγκρίνει ένα σύντομο αίτημα HTTP. Η εκτέλεση περιορισμένου εργαζομένου παραμένει ο τελικός έλεγχος.

ΤΑΧΥΔΡΟΜΙΚΗ ΥΠΗΡΕΣΙΑ/v1/jobsΠεδίο εφαρμογής: θέσεις εργασίας

Πεδίο	Τύπος	Απαιτείται	Περιγραφή
`media_source`	Διεύθυνση HTTPS	Ναι	Η ίδια κανονικοποιημένη πηγή που υποβλήθηκε για να επιλυθεί.
`media_variant`	συμβολοσειρά	Ναι	Ένα ακριβές αναγνωριστικό από την απόκριση επίλυσης.
`tenant`	συμβολοσειρά	Όχι.	Τομέας εκχωρημένου μισθωτή. Συνήθως παραλείπεται.

curl -X POST https://insto.app/v1/jobs \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_source":"https://www.youtube.com/watch?v=VIDEO_ID","media_variant":"18"}'

1202 ΑποδεκτέςΑποθήκευση prepare_id.

2Κατάσταση δημοσκόπησηςGET /v1/jobs/{prepare_id} με το ίδιο κλειδί.

3ΈτοιμοςΑνοίξτε τη διεύθυνση λήψης με υπογραφή.

Κατάσταση	Σημασία	Ενέργεια πελάτη
`queued`	Εισήχθη στην οριοθετημένη ουρά.	Δημοσκόπηση ξανά με backoff.
`extracting`	Ανανέωση μεταδεδομένων προέλευσης ή διαδρομής.	Συνεχίστε την ψηφοφορία.
`processing`	Κατέβασμα, αναμίξη ή συγχώνευση.	Εμφάνιση προόδου διακομιστή.
`ready`	Υπογραφή λήψης είναι διαθέσιμη.	Στείλτε τη διεύθυνση στο χρήστη.
`failed`	Τερματικό δομημένο σφάλμα.	Διαβάστε `error_code`. Επαναλάβετε μόνο όταν συμβουλεύεται.
`expired`	Η προσωρινή έξοδος αφαιρέθηκε.	Δημιουργήστε μια νέα εργασία.

curl https://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

Στο Insto, η αρχική αναμονή ενός δευτερολέπτου έρχεται πρώτη κατά την εξήγηση της ψηφοφορίας εργασίας. Ακολουθεί η ανασκόπηση λήψης με περιορισμένη επανάληψη και κλείνει με προσωρινή υπογεγραμμένη παράδοση.

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

Για να εξηγήσει το συμβόλαιο σφάλματος, το Insto διαχωρίζει έναν φάκελο μη 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.

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

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

Χρησιμοποιήστε λογική idempotent εφαρμογής και ποτέ δεν ξεκινούν διπλότυπες εργασίες για το ίδιο κλικ χρήστη.
Η προσωρινή μνήμη επιλύει τα μεταδεδομένα σύντομα, αλλά πάντα αντιμετωπίζει τις υπογεγραμμένες διευθύνσεις λήψης ως λήγουσες.
Χρησιμοποιήστε περιορισμένο εκθετικό backoff με jitter για 429, 503 και επαναληπτέα λάθη.
Επεξεργαστείτε μόνο δημόσια μέσα ή μέσα στα οποία έχετε εξουσιοδότηση πρόσβασης.Δεν παρακάμπτονται οι έλεγχοι και οι έλεγχοι πρόσβασης.
Διατηρήστε τα αναγνωριστικά αιτημάτων και τα αναγνωριστικά εργασιών σε ιδιωτικά λειτουργικά αρχεία καταγραφής.Μην καταγράφετε τις υποβληθείσες διευθύνσεις χωρίς λόγο.

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

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

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

Περιγράψτε το προϊόν οπτικών μέσων, την αναμενόμενη μηνιαία χρήση και τους τύπους αναρτήσεων που σκοπεύετε να διαχειριστείτε. Το Insto παρέχει μόνο τις απαραίτητες αρμοδιότητες ανάλυσης ή προετοιμασίας και ποτέ δεν αποθηκεύει το αναγνώσιμο διακριτικό.

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