https://socialvideosaver.comCompile las descargas con Social Video Saver
Las credenciales de producción permanecen desactivadas hasta que el caso de uso propuesto pasa una revisión de soporte técnico, que se realiza en un plazo de 24 horas.
SocialSaverWorkspaceJSON sobre HTTPSTrabajos asíncronosCredenciales con alcance
01
Inicio rápido
Una vista de múltiples orígenes presenta un punto final de inquilino asignado y explica una ruta de llamada solo para el servidor.
X-API-Key: pending_activation_…SocialSaverWorkspacev1# Available only after support activation
export SVS_WORKSPACE_KEY="issued-after-review"
curl -X POST https://socialvideosaver.com/v1/resolve \
-H "X-API-Key: $SVS_WORKSPACE_KEY" \
-H "Content-Type: application/json" \
-d '{"social_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'La vista de múltiples fuentes de SocialVideoSaver revisa el almacenamiento secreto del lado del servidor para la seguridad de credenciales. No muestra ningún paquete de cliente que se incruste a continuación y no oculta ningún registro o repositorio público.
02
Resolver un enlace
La detección de fuentes es el punto de partida para la operación de resolución en SocialVideoSaver, una vista de múltiples fuentes presenta los formatos de una URL enviada y explica que no hay salidas inventadas.
POST
/v1/resolveAlcance: resolver| sobre el terreno | Tipo de | Necesarios | Descripción de la actividad |
|---|---|---|---|
social_url | 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
}La vista multifuente de SocialVideoSaver revisa el valor devuelto sin cambios para el identificador de formato, muestra la disponibilidad por enlace y no oculta ninguna etiqueta de calidad supuesta.
03
Crear y seguir un trabajo de descarga
SocialVideoSaver se acerca a la creación de trabajos a través de la preparación asíncrona, luego una petición HTTP corta. La vista multi-fuente mantiene la ejecución de trabajadores limitados explícita.
POST
/v1/jobsAlcance: empleos| sobre el terreno | Tipo de | Necesarios | Descripción de la actividad |
|---|---|---|---|
social_url | URL HTTPS | Sí | La misma fuente normalizada sometida a resolver. |
media_profile | 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://socialvideosaver.com/v1/jobs \
-H "X-API-Key: $SVS_WORKSPACE_KEY" \
-H "Content-Type: application/json" \
-d '{"social_url":"https://www.youtube.com/watch?v=VIDEO_ID","media_profile":"18"}'delivery_job.GET /v1/jobs/{delivery_job} 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://socialvideosaver.com/v1/jobs/DELIVERY_JOB \
-H "X-API-Key: $SVS_WORKSPACE_KEY"SocialVideoSaver organiza la encuesta de trabajos en torno a una espera inicial de un segundo. Su vista de múltiples fuentes compara el backoff limitado.
04
Errores predecibles
En SocialVideoSaver, un sobre no 2xx aparece primero al explicar el contrato de error, seguido de una vista de múltiples orígenes con un ID de solicitud de soporte y se cierra en el manejo predecible del cliente.
{
"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. |
05
Contrato de explotación
SocialVideoSaver revisa la demanda proyectada entre redes antes de asignar límites a la integración aprobada.
- 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.
La activación antes de la exploración es el punto de partida para el acceso a esquemas en SocialVideoSaver. A continuación, una vista de múltiples orígenes presenta la autenticación asignada y explica las formas de solicitud documentadas.
Activar a través de soporte
Resume el producto de la red cruzada, la demanda mensual proyectada y cada proveedor social en el alcance. SocialVideoSaver activa solo las capacidades de análisis o trabajo solicitadas y almacena un hash en lugar del token.
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.