# Humicorn — Content-Import

Hier laedst du Bilder, Videos und Textwitze hoch. Eine Datei je Aufruf.
Es wird nichts sofort veroeffentlicht: alles landet im Eingang und geht
erst nach Pruefung und Duplikat-Abgleich in den Katalog.

## Hochladen

    curl -H "X-Import-Token: $TOKEN" \
         -F datei=@katze.jpg \
         -F quelle="Telegram @expops" \
         -F lizenz="CC-BY-4.0" \
         https://import.humicorn.com/

Jedes weitere -F feld=wert wird als Metadatum uebernommen. Fuer 5.000
Dateien am Stueck parallelisieren:

    ls *.jpg | xargs -P 8 -I{} curl -sS -H "X-Import-Token: $TOKEN" \
      -F datei=@{} -F quelle="Telegram @expops" https://import.humicorn.com/

## Felder — ALLE freiwillig

Ein Upload ganz ohne Metadaten funktioniert. Je mehr, desto besser.

Inhalt     titel text sprache bildsprache alt-text
Herkunft   quelle quell-url quell-id autor autor-url erschienen erfasst
Rechte     lizenz lizenz-url lizenzgeber vertrag lizenz-von lizenz-bis
           namensnennung nutzung gegenleistung
Resonanz   aufrufe likes dislikes reaktionen geteilt kommentare
           abonnenten resonanz-stand
Einordnung tags freie-tags nsfw warnung
Technik    dauer breite hoehe originaldatei
Betrieb    status gruppe ordner

Jeder weitere Schluessel wird uebernommen und aufbewahrt.

WICHTIG bei Resonanz: "likes" ohne "abonnenten" ist unbrauchbar. 5.000
Likes auf einem 20.000er-Kanal sind ein Treffer, auf einem 5-Millionen-
Kanal ein Ausfall. Immer beides mitschicken.

TAGS nur aus: wordplay absurd dad-joke anti-joke clever silly kids office
animals relationship politics everyday military regional drinking tech
money — hoechstens drei. Unbekannte werden verworfen, die Datei nicht.

"ordner" gruppiert einen Schwung (z. B. den Kanalnamen); fehlt "quelle",
wird der Ordnername zur Quelle.

## Erlaubt

png jpg jpeg gif webp mp4 webm mov mp3 wav ogg m4a txt, bis 64 MB.

## Antwort

201 und {"data":{"gespeichert":"<name>"}} bei Erfolg.
401 falscher Token, 400 unerlaubte Endung, 413 zu gross.

Vollstaendige Beschreibung: docs/METADATEN-KONVENTION.md im Repo.
