> ## Documentation Index > Fetch the complete documentation index at: https://docs.watahub.dev/llms.txt > Use this file to discover all available pages before exploring further. # Obtener la URL de descarga de un archivo > Obtener la URL de descarga de un archivo ## OpenAPI ````yaml es/openapi.json GET /v1/media/{id} openapi: 3.1.0 info: title: Watahub API version: 0.2.0 description: >- API para clientes de Watahub, gateway multiempresa de WhatsApp Cloud API. Autentica cada solicitud con `Authorization: Bearer ` o `X-API-Key: `. Los contratos propios son cerrados; los registros de Meta conservan campos adicionales. El proxy `/vN.N` conserva el cuerpo y estado de Meta; acepta la versión de la ruta, pero la ignora. servers: - url: https://cloud.watahub.dev security: - bearerApiKey: [] - headerApiKey: [] tags: - name: Messages - name: Media - name: Templates - name: Graph-compatible proxy description: >- Compatibilidad con Graph de Meta en tres rutas. Devuelve la respuesta de Meta sin cambios. - name: Phones description: Teléfonos - name: Conversations description: Conversaciones - name: Connect description: Conexión - name: Customers description: Clientes - name: Webhooks description: Webhooks - name: Logs description: Registros - name: Health description: Estado del servicio - name: Message templates description: >- Plantillas por WABA en caché del gateway, sincronizadas desde Meta y necesarias para campañas. - name: Broadcasts description: >- Envía una plantilla aprobada a hasta 500 destinatarios; se procesa en cola y en segundo plano. paths: /v1/media/{id}: parameters: - name: id in: path required: true schema: type: string pattern: ^\d{1,32}$ description: phoneNumberId para POST, mediaId para GET. get: tags: - Media summary: Obtener la URL de descarga de un archivo description: >- Solo archivos subidos o recibidos por esta cuenta. No devuelve `mime_type`, `sha256` ni `file_size` de Meta. operationId: getMedia parameters: - name: id in: path required: true description: ID del archivo. schema: $ref: '#/components/schemas/GraphId' - name: redirect in: query required: false description: '`true` devuelve 302 a la URL de Meta en vez de JSON.' schema: type: string enum: - 'true' responses: '200': description: URL de Meta para el archivo. content: application/json: schema: $ref: '#/components/schemas/MediaUrl' '302': description: Con `redirect=true`. headers: Location: description: URL de Meta para el archivo. schema: type: string format: uri 4XX: $ref: '#/components/responses/ClientError' 5XX: $ref: '#/components/responses/ServerError' components: schemas: GraphId: type: string pattern: ^\d+$ description: ID numérico de Graph de Meta. MediaUrl: type: object additionalProperties: false required: - mediaId - url properties: mediaId: type: string url: type: string description: >- URL temporal de Meta. Requiere el token de Meta del número: descarga mediante `GET /v1/media/{mediaId}/content`. GatewayError: type: object description: >- Error del gateway o core. `error` es un mensaje estable en inglés para desarrolladores. additionalProperties: false required: - error properties: error: type: string fields: type: array items: type: string description: 'Con 400 `Invalid fields`: rutas de los campos rechazados.' requestId: type: string description: 'Con 500 `Operation unavailable`: ID para facilitar a soporte.' ValidationError: type: object description: El core rechazó un valor del cuerpo, ruta, header o consulta. additionalProperties: false required: - error - details properties: error: const: Validation failed details: type: object description: Mensajes por nombre de campo. additionalProperties: type: array items: type: string MetaError: type: object description: >- Meta falló en `/v1`. Con error de Meta: `code`, `subcode`, `type` en envíos y clasificación del core. Si Meta es inaccesible o devuelve datos inutilizables, solo `message`, más `unknown_outcome` en envíos. additionalProperties: false required: - error properties: error: type: object additionalProperties: false required: - message properties: message: type: string code: type: integer description: >- Código de error de Meta; estado HTTP si Meta no proporciona código. subcode: type: integer description: '`error_subcode` de Meta.' type: type: string description: Tipo de error de Meta. Solo en envíos. category: type: string enum: - auth - billing - rate_limit - meta_server - unknown - unknown_outcome retryable: type: boolean action: type: string description: Qué hacer a continuación, en inglés. responses: ClientError: description: >- Rechazado por el gateway (`GatewayError`), la validación del core (`ValidationError`, 422) o Meta (`MetaError`, con su estado HTTP). content: application/json: schema: anyOf: - $ref: '#/components/schemas/GatewayError' - $ref: '#/components/schemas/ValidationError' - $ref: '#/components/schemas/MetaError' ServerError: description: >- `GatewayError` por fallo del gateway (500 con `requestId`, 503 por configuración ausente); `MetaError` por 5XX de Meta, conexión fallida (502) o timeout (504). content: application/json: schema: anyOf: - $ref: '#/components/schemas/GatewayError' - $ref: '#/components/schemas/MetaError' securitySchemes: bearerApiKey: type: http scheme: bearer description: Clave API de la cuenta. headerApiKey: type: apiKey in: header name: X-API-Key description: Clave API de la cuenta. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.