Solo vista previa — activación requerida

Compile 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.

InstoMediaJSON sobre HTTPSTrabajos asíncronosCredenciales con alcance
01

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.

URL del inquilinohttps://insto.app
AutenticaciónX-API-Key: pending_activation_…
Perfil del clienteInstoMedia
Versión de 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 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.

02

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.

POST/v1/resolveAlcance: resolver
sobre el terrenoTipo deNecesariosDescripción de la actividad
media_sourceURL HTTPSSíPágina de medios pública o autorizada a analizar.
tenantcadenaNoDominio 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.

03

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.

POST/v1/jobsAlcance: empleos
sobre el terrenoTipo deNecesariosDescripción de la actividad
media_sourceURL HTTPSSíLa misma fuente normalizada sometida a resolver.
media_variantcadenaSíUn ID exacto de la respuesta de resolución.
tenantcadenaNoDominio 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"}'
1202 AceptadasGuardar prepare_id.
2Estado de la encuestaGET /v1/jobs/{prepare_id} con la misma clave.
3ListoAbra la URL de descarga firmada.
Situación actualSignificadoAcción del cliente
queuedAdmitido en la cola acotada.Encuesta de nuevo con retroceso.
extractingActualización de metadatos de origen o ruta.Continúa encuestando.
processingDescargar, remuxar o fusionar.Mostrar el progreso del servidor.
readyDescarga firmada está disponible.Envía la URL al usuario.
failedError estructurado de terminal.Leer error_codeVuelva a intentarlo solo cuando se le indique.
expiredSe 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.

04

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": "…"
}
HTTPSignificado típicoMedidas
400URL, cuerpo o formato no disponible no válido.Corrija la solicitud. Vuelva a resolver los formatos.
401Falta clave, no válida, caducada o con alcance incorrecto.Compruebe la credencial del lado del servidor.
403La directiva de inquilino o de origen rechazó la solicitud.No elude la política. Contacte con el soporte.
404Trabajo desconocido o caducado.Cree un nuevo trabajo si es apropiado.
429Se alcanzó el límite de solicitudes o trabajos activos.Honor retry_after_seconds.
503Cola/capacidad o upstream temporalmente no disponible.Vuelva a intentarlo con retroceso exponencial y fluctuación.
05

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.

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.

ACCESO REVISADO POR EL OPERADOR

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.