> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubfy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter URL de download

> Operação sobre arquivos da conta.

Disponível para assets do tipo `file` no estado `ready`. Retorna uma URL temporária de download válida por uma hora. Guarde-a como credencial e solicite outra quando expirar.

Requer `assets:read` ou `read`. Veja [campos, relacionamentos e eventos](https://docs.hubfy.io/api-reference/assets/object.md).


## OpenAPI

````yaml api/v1/openapi.yaml GET /v1/assets/{id}/download
openapi: 3.1.0
info:
  title: Hubfy API
  version: 1.0.0
  description: >-
    API pública da Hubfy para produtos, preços, arquivos, clientes, pedidos e
    links de pagamento. Autenticação por chave da conta. GET consulta; POST
    cria, atualiza ou executa ações; DELETE remove ou desativa. O ambiente usa
    dados reais, sem sandbox separado. Consulte os fundamentos, os objetos e os
    eventos em https://docs.hubfy.io/api-reference/introduction.
servers:
  - url: https://api.hubfy.io
security:
  - apiKeyAuth: []
tags:
  - name: Produtos
    description: Objeto Product. Campos e relacionamentos na visão geral.
  - name: Preços
    description: Objeto Price. Campos e relacionamentos na visão geral.
  - name: Arquivos
    description: Objeto Asset. Campos e relacionamentos na visão geral.
  - name: Clientes
    description: Objeto Customer. Campos e relacionamentos na visão geral.
  - name: Pedidos
    description: Objeto Order. Campos e relacionamentos na visão geral.
  - name: Links de pagamento
    description: Objeto PaymentLink. Campos e relacionamentos na visão geral.
  - name: Fundamentos da API
    description: Conexão e identificação da API.
paths:
  /v1/assets/{id}/download:
    get:
      tags:
        - Arquivos
      summary: Obter URL de download
      description: >-
        Siga o fluxo de upload e download e utilize apenas a credencial
        temporária retornada para transferir conteúdo.


        Permissão: `assets:read` ou `read`. Consulte a [visão
        geral](/api-reference/assets/object) para campos e relacionamentos.
      operationId: getAssetDownload
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            pattern: ^ast_[a-z0-9]{16}$
          description: ID público do arquivo na conta.
      responses:
        '200':
          description: Operação concluída
          headers:
            X-Request-Id:
              description: Identifier of this HTTP request
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Download'
              example:
                asset: ast_1234567890abcdef
                expires_at: '2030-01-01T00:00:00.000Z'
                object: download
                url: https://downloads.example.com/temporary-credential
        '400':
          $ref: '#/components/responses/ApiFailure'
        '401':
          $ref: '#/components/responses/ApiFailure'
        '403':
          $ref: '#/components/responses/ApiFailure'
        '404':
          $ref: '#/components/responses/ApiFailure'
        '409':
          $ref: '#/components/responses/ApiFailure'
        '429':
          $ref: '#/components/responses/ApiFailure'
        '500':
          $ref: '#/components/responses/ApiFailure'
        '502':
          $ref: '#/components/responses/ApiFailure'
        '503':
          $ref: '#/components/responses/ApiFailure'
      security:
        - apiKeyAuth: []
components:
  schemas:
    Download:
      type: object
      additionalProperties: false
      required:
        - asset
        - expires_at
        - object
        - url
      properties:
        asset:
          type: string
          pattern: ^ast_[a-z0-9]{16}$
        expires_at:
          type: string
          format: date-time
        object:
          type: string
          const: download
        url:
          type: string
          format: uri
      example:
        asset: ast_1234567890abcdef
        expires_at: '2030-01-01T00:00:00.000Z'
        object: download
        url: https://downloads.example.com/temporary-credential
    ApiError:
      type: object
      additionalProperties: false
      required:
        - error
      properties:
        error:
          type: object
          additionalProperties: false
          required:
            - code
            - doc_url
            - message
            - param
            - type
          properties:
            code:
              type: string
            doc_url:
              type:
                - string
                - 'null'
            message:
              type: string
            param:
              type:
                - string
                - 'null'
            type:
              type: string
              enum:
                - invalid_request_error
                - authentication_error
                - permission_error
                - rate_limit_error
                - api_error
      example:
        error:
          code: invalid_parameter
          doc_url: null
          message: The request contains invalid parameters
          param: null
          type: invalid_request_error
  responses:
    ApiFailure:
      description: A operação não foi concluída
      headers:
        X-Request-Id:
          description: Identifier of this HTTP request
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
          example:
            error:
              code: invalid_parameter
              doc_url: null
              message: The request contains invalid parameters
              param: null
              type: invalid_request_error
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.