Transferências

Recuperar tudo

Ponto de Extremidade

GET https://transf.com.br/api/transfers/

Exemplo

curl --request GET \
--url 'https://transf.com.br/api/transfers/' \
--header 'Authorization: Bearer {api_key}' \

Parâmetros	Detalhes	Descrição
search	Opcional Texto	A string de pesquisa.
search_by	Opcional Texto	Por qual campo você está pesquisando. Os valores permitidos são: `url`, `name`.
datetime_field	Opcional Texto	Valores permitidos: `datetime`, `last_datetime`, `expiration_datetime`
datetime_start	Opcional Texto	Filtrar resultados a partir desta data e hora. Formato `Y-m-d H:i:s`.
datetime_end	Opcional Texto	Filtre os resultados até esta data e hora. Formato `Y-m-d H:i:s`.
order_by	Opcional Texto	Qual campo para ordenar os resultados. Valores permitidos são: `transfer_id`, `datetime`, `last_datetime`, `expiration_datetime`, `pageviews`, `downloads`, `url`, `name`, `downloads_limit`, `total_files`, `total_size`.
order_type	Opcional Texto	A ordenação dos resultados. Os valores permitidos são: `ASC` para ordenação crescente e `DESC` para ordenação decrescente.
page	Opcional Inteiro	O número da página da qual você deseja os resultados. Padrão é `1`.
results_per_page	Opcional Inteiro	Quantos resultados você deseja por página. Os valores permitidos são: `10`, `25`, `50`, `100`, `250`, `500`, `1000`. O padrão é `25`.

Exemplo de resposta

{
    "data": [
        {
            "id": 1,
            "user_id": 1,
            "project_id": 0,
            "uploader_id": "f528764d624db129b32c21fbca0cb8d6",
            "pixels_ids": [],
            "files_ids": [
                1,2,3
            ],
            "name": "Example",
            "description": "Example",
            "type": "link",
            "email_to": null,
            "url": "example",
            "settings": {
                "password": null,
                "file_encryption_is_enabled": false,
                "file_preview_is_enabled": true,
                "is_removed_branding": false,
                "custom_css": "tester",
                "custom_js": ""
            },
            "notifications": {
                "download": []
            },
            "total_files": 1,
            "total_size": 999999,
            "pageviews": 1,
            "downloads": 1,
            "downloads_limit": 0,
            "expiration_datetime": null,
            "last_datetime": null,
            "datetime": "2026-06-04 22:18:01",
        },
    ],
    "meta": {
        "page": 1,
        "results_per_page": 25,
        "total": 1,
        "total_pages": 1
    },
    "links": {
        "first": "https://transf.com.br/api/transfers?page=1",
        "last": "https://transf.com.br/api/transfers?page=1",
        "next": null,
        "prev": null,
        "self": "https://transf.com.br/api/transfers?page=1"
    }
}

Recuperar um

Ponto de Extremidade

GET https://transf.com.br/api/transfers/{transfer_id}

Exemplo

curl --request GET \
--url 'https://transf.com.br/api/transfers/{transfer_id}' \
--header 'Authorization: Bearer {api_key}' \

Exemplo de resposta

{
    "data": {
        "id": 1,
        "user_id": 1,
        "project_id": 0,
        "uploader_id": "f528764d624db129b32c21fbca0cb8d6",
        "pixels_ids": [],
        "files_ids": [
            1,2,3
        ],
        "name": "Example",
        "description": "Example",
        "type": "link",
        "email_to": null,
        "url": "example",
        "settings": {
            "password": null,
            "file_encryption_is_enabled": false,
            "file_preview_is_enabled": true,
            "is_removed_branding": false,
            "custom_css": "tester",
            "custom_js": ""
        },
        "notifications": {
            "download": []
        },
        "total_files": 1,
        "total_size": 999999,
        "pageviews": 1,
        "downloads": 1,
        "downloads_limit": 0,
        "expiration_datetime": null,
        "last_datetime": null,
        "datetime": "2026-06-04 22:18:01",
    }
}

Parâmetros	Detalhes	Descrição
uploaded_files	Necessário Vetor Inteiro	Array contendo os UUID's de todos os arquivos enviados para serem anexados a esta transferência.
type	Opcional Texto	Valores permitidos: `link`, `email`
email_to	Opcional Texto	Disponível quando: type = email
name	Opcional Texto	-
description	Opcional Texto	-
url	Opcional Texto	-
domain_id	Opcional Inteiro	-
project_id	Opcional Inteiro	-
pixels_ids	Opcional Vetor Inteiro	-
download_notification_handlers_ids	Opcional Vetor Inteiro	-
pageview_notification_handlers_ids	Opcional Vetor Inteiro	-
expiration_datetime	Opcional Texto	`Y-m-d H:i:s`
downloads_limit	Opcional Inteiro	-
password	Opcional Texto	-
file_encryption_is_enabled	Opcional Boolean	-
file_preview_is_enabled	Opcional Boolean	-
gallery_file_preview_is_enabled	Opcional Boolean	-
is_removed_branding	Opcional Boolean	-
custom_css	Opcional Texto	-
custom_js	Opcional Texto	-

curl --request POST \
--url 'https://transf.com.br/transfer/create_api' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'uploaded_files[]=de09be56-639f-4213-863b-5ea1aa065970' \
--form 'name=Example name' \
--form 'description=Example description' \

Exemplo de resposta

{
    "data": {
        "id": 1,
        "download_url": "https://transf.com.br/transfer-redirect/1",
        "view_url": "https://transf.com.br/transfer/1",
    }
}

Anexar novos arquivos

Ponto de Extremidade

POST https://transf.com.br/transfer/update_api

Parâmetros	Detalhes	Descrição
transfer_id	Necessário Inteiro	-
uploaded_files	Necessário Vetor Texto	Array contendo os UUID's de todos os arquivos enviados para serem anexados a esta transferência.

Exemplo

curl --request POST \
--url 'https://transf.com.br/transfer/update_api' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'transfer_id=1' \
--form 'uploaded_files[]={uploaded_file_uuid}' \
--form 'uploaded_files[]={uploaded_file_uuid}'

Exemplo de resposta

{
    "data": {
        "id": 1,
        "download_url": "https://transf.com.br/transfer-redirect/1",
        "view_url": "https://transf.com.br/transfer/1",
    }
}

Atualizar

Ponto de Extremidade

POST https://transf.com.br/api/transfers/{transfer_id}

Parâmetros	Detalhes	Descrição
name	Opcional Texto	-
description	Opcional Texto	-
url	Opcional Texto	-
domain_id	Opcional Inteiro	-
project_id	Opcional Inteiro	-
pixels_ids	Opcional Vetor Inteiro	-
download_notification_handlers_ids	Opcional Vetor Inteiro	-
pageview_notification_handlers_ids	Opcional Vetor Inteiro	-
expiration_datetime	Opcional Texto	`Y-m-d H:i:s`
downloads_limit	Opcional Inteiro	-
file_preview_is_enabled	Opcional Boolean	-
gallery_file_preview_is_enabled	Opcional Boolean	-
is_removed_branding	Opcional Boolean	-
custom_css	Opcional Texto	-
custom_js	Opcional Texto	-

Exemplo

curl --request POST \
--url 'https://transf.com.br/api/transfers/{transfer_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'host=transfer.com' \

Exemplo de resposta

{
    "data": {
        "id": 1
    }
}

Excluir

Ponto de Extremidade

DELETE https://transf.com.br/api/transfers/{transfer_id}

Exemplo

curl --request DELETE \
--url 'https://transf.com.br/api/transfers/{transfer_id}' \
--header 'Authorization: Bearer {api_key}' \

Recuperar tudo

Recuperar um

Criar

Anexar novos arquivos

Atualizar

Excluir