Documentation API KenFile

Description

Cette API permet de gérer le stockage de fichiers en ligne. Vous pouvez l'utiliser pour uploader, consulter, mettre à jour ou supprimer des fichiers via des requêtes HTTP.

Routes Disponibles

1. Lister les fichiers

Route : GET /api/files

Réponse :

{
    "status": "success",
    "message": "List of files retrieved successfully.",
    "data": [
        { "id": 1, "path": "files/file1.png", "created_at": "2023-01-01" },
        ...
    ]
}

Exemple Flutter :

import 'package:http/http.dart' as http;
import 'dart:convert';

Future listFiles() async {
    final response = await http.get(Uri.parse('https://votre-api.com/api/files'));

    if (response.statusCode == 200) {
        var data = json.decode(response.body);
        print('Fichiers: \${data["data"]}');
    } else {
        print('Erreur: \${response.statusCode}');
    }
}

2. Ajouter un fichier

Route : POST /api/files

Paramètres :

{
    "file": "Fichier à uploader (max: 2 Mo)"
}

Réponse :

{
    "status": "success",
    "message": "File uploaded successfully.",
    "data": { "id": 1, "path": "files/file1.png" }
}

Exemple Flutter :

import 'package:http/http.dart' as http;

Future uploadFile(String filePath) async {
    var request = http.MultipartRequest(
        'POST', Uri.parse('https://votre-api.com/api/files'));
    request.files.add(await http.MultipartFile.fromPath('file', filePath));

    var response = await request.send();
    if (response.statusCode == 201) {
        print('Fichier uploadé avec succès');
    } else {
        print('Erreur: \${response.statusCode}');
    }
}

3. Voir un fichier

Route : GET /api/files/{id}

Réponse :

{
    "status": "success",
    "message": "File retrieved successfully.",
    "data": { "id": 1, "path": "files/file1.png" }
}

Exemple Flutter :

import 'package:http/http.dart' as http;
import 'dart:convert';

Future getFile(int fileId) async {
    final response = await http.get(Uri.parse('https://votre-api.com/api/files/\$fileId'));

    if (response.statusCode == 200) {
        var data = json.decode(response.body);
        print('Fichier récupéré : \${data["data"]}');
    } else {
        print('Erreur: \${response.statusCode}');
    }
}