Upload API (zum Hochladen von Daten)

In diesem Abschnitt wird beschrieben, wie du die File Upload API verwenden kannst, um Dateien und Webpages in Ordner hochzuladen, Daten abzufragen und Elemente zu löschen. Diese API erlaubt es dir, mit Ordnern und Dateien zu arbeiten, indem du einfache HTTP-Anfragen sendest.

In diesem Abschnitt wird beschrieben, wie du die File Upload API verwenden kannst, um Dateien und Webpages in Ordner hochzuladen, Daten abzufragen und Elemente zu löschen. Diese API erlaubt es dir, mit Ordnern und Dateien zu arbeiten, indem du einfache HTTP-Anfragen sendest.

Übersicht der API-Endpunkte

• Datei hochladen:
  POST /localmind/public-upload/file

• Webseite hochladen:
  POST /localmind/public-upload/web-page

• Dateien in einem Ordner abrufen:
  GET /localmind/public-upload/folders/{folder_id}/files

• Webseiten in einem Ordner abrufen:
  GET /localmind/public-upload/folders/{folder_id}/web-pages

• Dateien löschen:
  DELETE /localmind/public-upload/files

• Webseiten löschen:
  DELETE /localmind/public-upload/web-pages

1. Hochladen von Dateien

Um eine Datei in einen bestimmten Ordner hochzuladen, sende eine POST-Anfrage an den Endpunkt /localmind/public-upload/file mit den folgenden Feldern im Body:

Beispiel

POST /localmind/public-upload/file

Content-Type: multipart/form-data

curl -X 'POST' \
  'https://*IHRE_LOCALMIND_INSTANZ*.localmind.io/localmind/public-upload/file' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer *IHR_API_KEY*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'uploadedfile=@/Pfad/zur/Datei/beispiel.txt' \
  -F 'folder_id=12345' \
  -F 'name=beispiel.txt'

{
  "status": "success",
  "data": {}
}

2. Hochladen einer Webseite

Du kannst auch URLs von Webseiten in einem Ordner speichern. Verwende dafür den Endpunkt /localmind/public-upload/web-page und übermittle die folgenden Daten im Body:

Beispiel

POST /localmind/public-upload/web-page

Content-Type: application/json

curl -X 'POST' \
  'https://*IHRE_LOCALMIND_INSTANZ*.localmind.io/localmind/public-upload/web-page' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer *IHR_API_KEY*' \
  -H 'Content-Type: application/json' \
  -d '{
        "url": "https://beispiel.com",
        "name": "Meine Webseite",
        "folder_id": "12345"
      }'

{
  "status": "success",
  "data": {}
}

3. Abrufen von Dateien in einem Ordner

Um eine Liste der Dateien in einem bestimmten Ordner zu erhalten, sende eine GET-Anfrage an den Endpunkt /localmind/public-upload/folders/{folder_id}/files:

Beispiel

curl -X 'GET' \
  'https://*IHRE_LOCALMIND_INSTANZ*.localmind.io/localmind/public-upload/folders/12345/files' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer *IHR_API_KEY*'

Antwort

{
  "data": [
    {
      "file_id": "1",
      "name": "beispiel.txt"
    }
  ]
}

4. Abrufen von Webseiten in einem Ordner

Ähnlich wie bei den Dateien kannst du eine Liste der gespeicherten Webseiten abrufen, indem du eine GET-Anfrage an den Endpunkt /localmind/public-upload/folders/{folder_id}/web-pages sendest:

Beispiel

curl -X 'GET' \
  'https://*IHRE_LOCALMIND_INSTANZ*.localmind.io/localmind/public-upload/folders/12345/web-pages' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer *IHR_API_KEY*'

Antwort

{
  "data": [
    {
      "page_id": "1",
      "name": "Meine Webseite",
      "url": "https://beispiel.com"
    }
  ]
}

5. Löschen von Dateien

Um eine oder mehrere Dateien aus einem Ordner zu löschen, sende eine DELETE-Anfrage an den Endpunkt /localmind/public-upload/files mit den Dateiinformationen im Body:

Beispiel

DELETE /localmind/public-upload/files

Content-Type: application/json

curl -X 'DELETE' \
  'https://*IHRE_LOCALMIND_INSTANZ*.localmind.io/localmind/public-upload/files' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer *IHR_API_KEY*' \
  -H 'Content-Type: application/json' \
  -d '{
        "folder_id": "12345",
        "file_ids": ["1","2"]
      }'

Antwort

{
  "status": "success",
  "deleted_files": [
    "1",
    "2"
  ]
}

6. Löschen von Webseiten

Zum Löschen von Webseiten verwende den Endpunkt /localmind/public-upload/web-pages mit den folgenden Daten im Body:

Beispiel

DELETE /localmind/public-upload/web-pages

Content-Type: application/json

curl -X 'DELETE' \
  'https://*IHRE_LOCALMIND_INSTANZ*.localmind.io/localmind/public-upload/web-pages' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer *IHR_API_KEY*' \
  -H 'Content-Type: application/json' \
  -d '{
        "folder_id": "12345",
        "page_ids": ["1","2"]
      }'

{
  "status": "success",
  "deleted_pages": [
    "1",
    "2"
  ]
}