Preview only — activation required

Build downloads with EasyF

EasyF shows the interface in advance so developers can estimate their work. A support review is still required before a live key and usage boundary exist.

EasyfClientJSON sobre HTTPSTrabajos asíncronosCredenciales con alcance

Inicio rápido

To explain API host, EasyF separates support-activated credentials from an assigned tenant endpoint. A plain-language workflow gives a server-only call path its own place.

URL del inquilinohttps://easyf.app

AutenticaciónX-API-Key: pending_activation_…

Perfil del clienteEasyfClient

Versión de APIv1

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

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

Credential safety starts with server-side secret storage on EasyF. The next view covers no client bundle embedding. The page keeps no public logs or repositories visible.

Resolver un enlace

To explain Resolve operation, EasyF separates source detection from formats from one submitted URL. A plain-language workflow gives no invented outputs its own place.

POST/v1/resolveAlcance: resolver

sobre el terreno	Tipo de	Necesarios	Descripción de la actividad
`asset_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
}

Format identifier starts with the returned value unchanged on EasyF. The next view covers per-link availability. The page keeps no guessed quality label visible.

Crear y seguir un trabajo de descarga

EasyF presents three practical points for Job creation. First comes asynchronous preparation. The plain-language workflow then covers a short HTTP request. Its final point is bounded worker execution.

POST/v1/jobsAlcance: empleos

sobre el terreno	Tipo de	Necesarios	Descripción de la actividad
`asset_url`	URL HTTPS	Sí	La misma fuente normalizada sometida a resolver.
`variant_code`	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://easyf.app/v1/jobs \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'

1202 AceptadasSave delivery_id.

2Estado de la encuestaGET /v1/jobs/{delivery_id} with the same key.

3ListoAbra la URL de descarga firmada.

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.	Read `error_code`. Retry only when advised.
`expired`	Se eliminó la salida temporal.	Crea un nuevo trabajo.

curl https://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

EasyF approaches Job polling through one-second initial wait, then capped backoff. The plain-language workflow keeps temporary signed delivery explicit.

Errores predecibles

EasyF organizes Error contract around one non-2xx envelope. Its plain-language workflow compares a support request ID. Predictable client handling remains the final check.

{
  "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

EasyF agrees practical usage bounds with each approved product to preserve a predictable guided workflow.

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.
Use bounded exponential backoff with jitter for 429, 503 and retryable errors.
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.

To explain Schema access, EasyF separates activation before exploration from assigned authentication. A plain-language workflow gives documented request shapes its own place.

ACCESO REVISADO POR EL OPERADOR

Activate through support

Tell EasyF what you are building, how often it will call the API and which providers matter. The review decides the permitted operations, then reveals a credential once while saving only its secure digest.

Request activation Las claves están limitadas al ámbito del inquilino, son revocables y se emiten a través del formulario de contacto.