https://insto.appCompile las descargas con Insto
Insto El análisis en vivo y las solicitudes de trabajo no están disponibles hasta que el soporte técnico concede la autorización con alcance de inquilino.
Inicio rápido
Para el host de API,Insto Su revisión de descarga empareja esa información con un punto final de inquilino asignado y termina con una ruta de llamada solo para el servidor.
X-API-Key: pending_activation_…InstoMediav1# 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 presenta tres puntos prácticos para la seguridad de credenciales. Primero viene el almacenamiento secreto del lado del servidor. La revisión de descarga luego cubre la incrustación de paquetes de clientes. Su punto final es que no hay registros ni repositorios públicos.
Resolver un enlace
Para la operación de resolución, Insto comienza con la detección de origen, su revisión de descarga empareja eso con formatos de una URL enviada y termina sin salidas inventadas.
/v1/resolveAlcance: resolver| sobre el terreno | Tipo de | Necesarios | Descripción de la actividad |
|---|---|---|---|
media_source | URL HTTPS | Sí | Página de medios pública o autorizada a analizar. |
tenant | cadena | No | Dominio de inquilino asignado. Por lo general, se omite. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}Insto presenta tres puntos prácticos para el identificador de formato. Primero viene el valor devuelto sin cambios. La revisión de descarga luego cubre la disponibilidad por enlace. Su punto final es ninguna etiqueta de calidad adivinada.
Crear y seguir un trabajo de descarga
Insto organiza la creación de trabajos en torno a la preparación asíncrona. Su revisión de descarga compara una solicitud HTTP corta, mientras que la ejecución de trabajadores limitados sigue siendo la comprobación final.
/v1/jobsAlcance: empleos| sobre el terreno | Tipo de | Necesarios | Descripción de la actividad |
|---|---|---|---|
media_source | URL HTTPS | Sí | La misma fuente normalizada sometida a resolver. |
media_variant | cadena | Sí | Un ID exacto de la respuesta de resolución. |
tenant | cadena | No | Dominio de inquilino asignado. Por lo general, se omite. |
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"}'prepare_id.GET /v1/jobs/{prepare_id} con la misma clave.| Situación actual | Significado | Acción del cliente |
|---|---|---|
queued | Admitido en la cola acotada. | Encuesta de nuevo con retroceso. |
extracting | Actualización de metadatos de origen o ruta. | Continúa encuestando. |
processing | Descargar, remuxar o fusionar. | Mostrar el progreso del servidor. |
ready | Descarga firmada está disponible. | Envía la URL al usuario. |
failed | Error estructurado de terminal. | Leer error_codeVuelva a intentarlo solo cuando se le indique. |
expired | Se eliminó la salida temporal. | Crea un nuevo trabajo. |
curl https://insto.app/v1/jobs/PREPARE_ID \
-H "X-API-Key: $INSTO_MEDIA_TOKEN"En Insto, la espera inicial de un segundo aparece primero al explicar la sondeo de trabajos. Esa revisión de descarga sigue con un backoff limitado y se cierra en la entrega temporal firmada.
Errores predecibles
Para explicar el contrato de error, Insto separa un sobre que no es 2xx de un ID de solicitud de soporte.
{
"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 | Significado típico | Medidas |
|---|---|---|
| 400 | URL, cuerpo o formato no disponible no válido. | Corrija la solicitud. Vuelva a resolver los formatos. |
| 401 | Falta clave, no válida, caducada o con alcance incorrecto. | Compruebe la credencial del lado del servidor. |
| 403 | La directiva de inquilino o de origen rechazó la solicitud. | No elude la política. Contacte con el soporte. |
| 404 | Trabajo desconocido o caducado. | Cree un nuevo trabajo si es apropiado. |
| 429 | Se alcanzó el límite de solicitudes o trabajos activos. | Honor retry_after_seconds. |
| 503 | Cola/capacidad o upstream temporalmente no disponible. | Vuelva a intentarlo con retroceso exponencial y fluctuación. |
Contrato de explotación
Insto adapta los límites de llamada al caso de uso de medios visuales y a las redes con las que el cliente aprobado se pondrá en contacto.
- Utilice la lógica de aplicación idempotente y nunca inicie trabajos duplicados para el mismo clic del usuario.
- La caché resuelve los metadatos brevemente, pero siempre trata las URL de descarga firmadas como si expiraran.
- Usar retroceso exponencial acotado con jitter para
429,503y errores reintentables. - Procesa solo medios públicos o medios a los que estás autorizado a acceder, sin omitir los controles de acceso ni DRM.
- Mantenga los ID de solicitud y los ID de trabajo en registros operativos privados. No registre las URL enviadas innecesariamente.
Para el acceso a esquemas, Insto comienza con la activación antes de la exploración, su revisión de descarga empareja eso con la autenticación asignada y termina con las formas de solicitud documentadas.
Activar a través de soporte
Describa el producto de medios visuales, el uso mensual previsto y los tipos de publicación que planea administrar.Insto concede solo los ámbitos de análisis o preparación necesarios y nunca almacena el token legible.
Solicitar activación de cuenta Las claves están limitadas al ámbito del inquilino, son revocables y se emiten a través del formulario de contacto.