Transferts

Récupérer la liste complète

GET https://transfer.meerabl.com/api/transfers/
curl --request GET \
--url 'https://transfer.meerabl.com/api/transfers/' \
--header 'Authorization: Bearer {api_key}' \
Paramètres Détails Description
search Facultatif Chaîne de caractères Chaîne de recherche.
search_by Facultatif Chaîne de caractères Champ dans lequel effectuer la recherche. Valeurs autorisées : url, name.
domain_id Facultatif Entier
datetime_field Facultatif Chaîne de caractères Valeurs autorisées : datetime, last_datetime, expiration_datetime
datetime_start Facultatif Chaîne de caractères Filtrer les résultats à partir de cette date et heure. Format : Y-m-d H:i:s.
datetime_end Facultatif Chaîne de caractères Filtrer les résultats jusqu'à cette date et heure. Format : Y-m-d H:i:s.
order_by Facultatif Chaîne de caractères Champ utilisé pour trier les résultats. Valeurs autorisées : transfer_id, datetime, last_datetime, expiration_datetime, pageviews, downloads, url, name, downloads_limit, total_files, total_size.
order_type Facultatif Chaîne de caractères Sens du tri. Valeurs autorisées : ASC pour un ordre croissant et DESC pour un ordre décroissant.
page Facultatif Entier Numéro de la page à récupérer. Valeur par défaut : 1.
results_per_page Facultatif Entier Nombre de résultats souhaité par page. Valeurs autorisées : 10, 25, 50, 100, 250, 500, 1000. Valeur par défaut : 25. 
{
    "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-09-15 20:53:26",
        },
    ],
    "meta": {
        "page": 1,
        "results_per_page": 25,
        "total": 1,
        "total_pages": 1
    },
    "links": {
        "first": "https://transfer.meerabl.com/api/transfers?page=1",
        "last": "https://transfer.meerabl.com/api/transfers?page=1",
        "next": null,
        "prev": null,
        "self": "https://transfer.meerabl.com/api/transfers?page=1"
    }
}

Récupérer un élément

GET https://transfer.meerabl.com/api/transfers/{transfer_id}
curl --request GET \
--url 'https://transfer.meerabl.com/api/transfers/{transfer_id}' \
--header 'Authorization: Bearer {api_key}' \ 
{
    "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-09-15 20:53:26",
    }
}

Créer

POST https://transfer.meerabl.com/transfer/create_api
Paramètres Détails Description
uploaded_files Obligatoire Tableau Entier Tableau contenant les UUID de tous les fichiers téléversés à joindre à ce transfert.
type Facultatif Chaîne de caractères Valeurs autorisées : link, email
email_to Facultatif Chaîne de caractères Disponible lorsque : type = email
name Facultatif Chaîne de caractères -
description Facultatif Chaîne de caractères -
url Facultatif Chaîne de caractères -
domain_id Facultatif Entier -
project_id Facultatif Entier -
pixels_ids Facultatif Tableau Entier -
download_notification_handlers_ids Facultatif Tableau Entier -
pageview_notification_handlers_ids Facultatif Tableau Entier -
expiration_datetime Facultatif Chaîne de caractères Y-m-d H:i:s
downloads_limit Facultatif Entier -
password Facultatif Chaîne de caractères -
file_encryption_is_enabled Facultatif Booléen -
file_preview_is_enabled Facultatif Booléen -
gallery_file_preview_is_enabled Facultatif Booléen -
is_removed_branding Facultatif Booléen -
custom_css Facultatif Chaîne de caractères -
custom_js Facultatif Chaîne de caractères -
curl --request POST \
--url 'https://transfer.meerabl.com/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' \
{
    "data": {
        "id": 1,
        "download_url": "https://transfer.meerabl.com/transfer-redirect/1",
        "view_url": "https://transfer.meerabl.com/transfer/1",
    }
}

Joindre de nouveaux fichiers

POST https://transfer.meerabl.com/transfer/update_api
Paramètres Détails Description
transfer_id Obligatoire Entier -
uploaded_files Obligatoire Tableau Chaîne de caractères Tableau contenant les UUID de tous les fichiers téléversés à joindre à ce transfert.
curl --request POST \
--url 'https://transfer.meerabl.com/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}' 
{
    "data": {
        "id": 1,
        "download_url": "https://transfer.meerabl.com/transfer-redirect/1",
        "view_url": "https://transfer.meerabl.com/transfer/1",
    }
}

Mettre à jour

POST https://transfer.meerabl.com/api/transfers/{transfer_id}
Paramètres Détails Description
name Facultatif Chaîne de caractères -
description Facultatif Chaîne de caractères -
url Facultatif Chaîne de caractères -
domain_id Facultatif Entier -
project_id Facultatif Entier -
pixels_ids Facultatif Tableau Entier -
download_notification_handlers_ids Facultatif Tableau Entier -
pageview_notification_handlers_ids Facultatif Tableau Entier -
expiration_datetime Facultatif Chaîne de caractères Y-m-d H:i:s
downloads_limit Facultatif Entier -
file_preview_is_enabled Facultatif Booléen -
gallery_file_preview_is_enabled Facultatif Booléen -
is_removed_branding Facultatif Booléen -
custom_css Facultatif Chaîne de caractères -
custom_js Facultatif Chaîne de caractères -
curl --request POST \
--url 'https://transfer.meerabl.com/api/transfers/{transfer_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'host=transfer.com' \
{
    "data": {
        "id": 1
    }
}

Supprimer

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