Datei signieren

POST

/sign-image-v2

• Production

Signiert eine Datei mit NIP-94 und veröffentlicht sie auf Nostr Relays.

Unterstützte Formate:

• Bilder: WebP, PNG, JPEG, GIF
• Dokumente: PDF
• Text: Markdown (.md), Plain Text (.txt)

Die Datei muss einen gültigen Autor haben:

• Bilder: In XMP-Metadaten (dc:creator)
• PDF: In PDF-Info (/Author)
• Markdown/Text: Im YAML Frontmatter (author:)

Request Body ^required

object

file

Datei (Bild, PDF, Markdown, Text)

string format: binary

image

Alias für file (Backwards Compatible)

string format: binary

url

Alternative - Datei-URL statt Upload

string format: uri

object

file_base64

Datei als Base64-String

string

image_base64

Alias für file_base64 (Backwards Compatible)

string

file_url

Öffentlich erreichbare Datei-URL

string format: uri

image_url

Alias für file_url (Backwards Compatible)

string format: uri

filename

Dateiname (für Typ-Erkennung bei Base64)

string

Responses

200

Datei erfolgreich signiert

object

success

boolean

Example

true

hash

SHA-256 Hash

string

Example

8a97b9bedaddf1096325fa44cec4f6f43b57273230c5bdae003b613b896252ea

file_type

Erkannter Dateityp

string

Allowed values: image document text

Example

text

metadata

object

author

string

Example

Steven Noack

title

string

Example

VisionFusen - Roadmap & Ideen

description

string

dimensions

Nur für Bilder

object

width

integer

height

integer

mime_type

string

Example

text/markdown

size_bytes

integer

Example

12543

event

Signiertes NIP-94 Event (Kind 1063)

object

published_to

Array<string>

Example

[
  "relay.visionfusen.org",
  "relay.damus.io",
  "relay.primal.net",
  "nos.lol"
]

urls

object

file

CDN-URL der Datei

string

Example

https://cdn.visionfusen.org/documents/visionfusen-roadmap-ideen.vf1063-8a97b9be.md

static_page

LLM-optimierte HTML-Seite

string

Example

https://cdn.visionfusen.org/events/14b89a28.../index.html

event_page

Event-Seite auf visionfusen.org

string

Example

https://visionfusen.org/event/14b89a28...

verify

Verifizierungs-URL

string

Example

https://visionfusen.org/verify?hash=8a97b9be...

400

Ungültige Anfrage

object

error

string

Allowed values: NO_FILE AUTHOR_REQUIRED FILE_TOO_LARGE INVALID_FORMAT ALREADY_SIGNED FILE_FETCH_FAILED

message

string

hint

string

supported

Liste unterstützter MIME-Types (bei INVALID_FORMAT)

Array<string>

Examples

Keine Datei

{
  "error": "NO_FILE",
  "message": "Keine Datei oder URL angegeben"
}

Autor fehlt

{
  "error": "AUTHOR_REQUIRED",
  "message": "Datei muss einen gültigen Autor haben.",
  "hint": "Füge YAML Frontmatter mit author: hinzu."
}

Format nicht unterstützt

{
  "error": "INVALID_FORMAT",
  "message": "Format nicht unterstützt: application/zip",
  "supported": [
    "image/webp",
    "image/png",
    "image/jpeg",
    "image/gif",
    "application/pdf",
    "text/markdown",
    "text/plain"
  ]
}

409

Datei bereits signiert

object

error

string

Example

ALREADY_SIGNED

message

string

Example

Diese Datei wurde bereits signiert.

existing_event

object