API

Sollte es tatsächlich einen Grund geben, dass du automatisiert auf meine Bilder und Video zugreifen möchtest, dann kannst du gerne meine REST API verwenden. Dabei kannst du über einfache GET-Requests und ohne Authentifizierung auf alle relevanten Information meiner Bilder und Videos zugreifen.

Auflisten

Nachstehender GET-Request listet alle verfügbaren Videos und Bilder auf. Dabei enthält die Liste/Dictionary alle Medien-IDs samt Information zum Bild/Video.

Auflisten aller verfügbaren Bilder und Videos

            
GET https://sebastianknoll.net/photo/portfolio/list
            
            
{
    "Info": "List all medias (images and videos)",
    "Media": {
        "ID01": { ... },
        "ID02": { ... },
        "ID03": { ... },
        "ID04": { ... },
        .
        .
        .
    }
}
            
            

---

Details

Nachstehender GET-Request liefert alle verfügbaren Information zu einem speziellen Bild oder Video. Dabei enthalten sind grundlegende Informationen wie Titel, Beschreibung (jeweils in Englisch und Deutsch), Ortsangaben und Aufnahme-Techniken. Zusätzlich finden sich Informationen zu internen und externen Referenzen, mögliche Produkte im Shop und Referenzen auf ähnliche Videos und Bilder.

Details zu einem speziellen Video oder Bild

            
GET https://sebastianknoll.net/photo/portfolio/info/ID
            
            
{
    "id": "NZ14",
    "type": "image",
    "title": "M O U N T . T A R A N A K I",
    "description": "Mount Taranaki in the Egmont ...",
    "title_de": "M O U N T . T A R A N A K I",
    "description_de": "Mount Taranaki im Egmont ...",
    "date": "2022-10-22",
    "location": {
        "country": "New Zealand",
        "location": "Egmont National Park"
    },
    "settings": {
        "camera": "Sony A7III",
        "iso": "3200",
        "exposure": "13",
        "focalLength": "20",
        "fStop": "2.8",
        "notes": null
    },
    "tagCount": 2,
    "tags": [
        "Astro",
        "NewZealand"
    ],
    "priority": "100",
    "externalLink": null,
    "panoramaAvailable": false,
    "panorama": null,
    "url": "https:\/\/sebastianknoll.net\/photo\/portfolio\/NZ14",
    "url_view": "https:\/\/sebastianknoll.net\/photo\/view\/NZ14",
    "url_view_en": "https:\/\/sebastianknoll.net\/photo\/en\/view\/Mount-Tranaki",
    "url_view_de": "https:\/\/sebastianknoll.net\/photo\/de\/view\/Mount-Tranaki",
    "server": {
        "original": "not permitted",
        "high": "not permitted",
        "medium": "not permitted",
        "low": "not permitted",
        "micro": null
    },
    "editing_notes": "not permitted",
    "instagram": null,
    "blog": null,
    "shop": {
        "url": null,
        "gtc": "https:\/\/sebastianknoll.net\/photo\/en\/gtc",
        "cheapest_product": { ... },
        "products": [{...}, {...}, ...  ]
    },
    "google": null,
    "google_maps": null,
    "facebook": null,
    "similar": ["NZ60", "NZ38", "NZ47", "NZ16", "NZ15"]
}
            
        

---

Tags

Alle Bilder und Videos sind mit Tags versehen und können nach diesen gefiltert werden. Ebenso können alle verfügbaren Tags abgerufen werden, wobei Information zu Verwendung (Anzahl der Bilder und Videos mit dem entsprechenden Tag) mit gesendet werden.

Auflistung aller verfügbaren Tags/Stichworten

            
GET https://sebastianknoll.net/photo/portfolio/tags
            
            
{
    "Architecture": {
        "tag": "Architecture",
        "description": "City, Architecture and buildings",
        "mediaCount": 4,
        "images": 1,
        "videos": 3
    },
    "Astro": {
        "tag": "Astro",
        "description": "Astrophotography",
        "mediaCount": 32,
        "images": 24,
        "videos": 8
    },
    .
    .
    .
}
            
        

Filter aller Bilder und Videos nach Tags/Stichwörtern

            
GET https://sebastianknoll.net/photo/portfolio/tag/astro
            
            
{
    "Info": "Medias (images and videos) with tag astro",
    "Media": {
        "ID01": { ... },
        "ID02": { ... },
        "ID03": { ... },
        "ID04": { ... },
        .
        .
        .
    }
}
        
        

---

Aufruf eines Bildes oder Videos

Bilder und Videos können mit nachstehenden Requests aufgerufen werden und sind in unterschiedlicher Qualität verfügbar. Dabei sind die Werte 'high' für hohe Qualität, 'medium' für mittlere Qualität und 'low' für niedrige Qualität verfügbar. Bei Bildern steht zusätzlich die Option 'micro' für eine minimalste Qualität zur Verfügung. Dabei entspricht 'high' einer ungefähren Auflösung von 4k (3840x2160), 'medium' einer ungefähren Auflösung von Full HD (1920x1080) und 'low' einer ungefähren Auflösung von SD (720x480). Die Option 'micro' wird ausschließlich für eine verschwommene Vorschau verwendet bis eine bessere Qualität vom Webbrowser geladen wurde. Der Download-Request stellt die Bilder/Videos ausschließlich in mittlerer Qualität ('medium', Full HD) bereit. Für Qualitäten über 'high' kannst du mich gerne jederzeit kontaktieren.

Aurufen eine Bildes

        
GET https://sebastianknoll.net/photo/media/ID/QUALITY/

QUALITY in {high, medium, low, micro}
        
        
https://sebastianknoll.net/photo/portfolio/NZ60/low
        
        

Aurufen eines Videos

        
GET https://sebastianknoll.net/photo/media/ID/QUALITY

QUALITY in {high, medium, low}
        
        
https://sebastianknoll.net/photo/portfolio/NZ39/low
        
        

---

Download

        
GET https://sebastianknoll.net/photo/portfolio/download/ID