Die mediainfo API

Die mediainfo erlaubt es Herausgebern von digitalen Medien festzulegen, welchen Umgang sie mit Ihren im Internet abrufbaren Inhalten wünschen. Da jeden Tag neue Medien hinzukommen und die Einstellungen sich regelmäßig ändern können, bietet mediainfo mit der API eine Lösung an, wie diese Einstellungen zu jeder Domain automatisiert abgerufen und berücksichtigt werden können.

So kann zum Beispiel ein Nachrichten-Aggregator wie Yigg.de oder Virato.de prüfen, wie viele Zeichen Textanriss er von einem Artikel von Bild.de anzeigen darf.

Stand 20.09.2012

Technische Funktionsweise

Beispiel-Anfrage für die Webseite PlanetVita.de:
http://www.mediainfo.de/api/get-permissions/url/planetvita.de

oder als JSON:
http://www.mediainfo.de/api/get-permissions/url/planetvita.de/format/json

Antwort-Formate:
<MediaInfo>

	<mediaInfo>
		<domain>planetvita.de<domain/>
		<title>Playstation VITA Magazin<title/>
	</mediaInfo>
	
	<permissions>
		<logo>16x16</logo>
		<thumbnailIndex>600x600</thumbnailIndex>
		<thumbnailArticle>600x600</thumbnailArticle>
		<linkTitleLength>300</linkTitleLength>
		<snippetLength>350</snippetLength>
		<iframe>yes</iframe>
		<fullText>
			<allowedFor>accessibility</allowedFor>
			<allowedFor>mobility</allowedFor>
			<allowedFor>usability</allowedFor>
		</fullText>
	</permissions>
	
</MediaInfo>    
    
{
   "mediaInfo":{
      "domain":"planetvita.de",
      "title":"Playstation VITA Magazin"
   },
   "permissions":{
      "logo":"16x16",
      "thumbnailIndex":"600x600",
      "thumbnailArticle":"600x600",
      "linkTitleLength":"300",
      "snippetLength":"350",
      "iFrame":"no",
      "fulltext":[
         "accessibility",
         "mobility",
         "usability"
      ]
   }
}
    

Rückgabewerte für permissions und deren Bedeutung:
logo Beschreibt, in welchem Umfang das Logo eine Webseite von Dritten genutzt werden darf.

  • unlimited (Beliebige Größe)
  • 16x16 (bis 16x16 Pixel - Favicon-Größe)
  • 80x80 (bis zu 80x80 Pixel )
  • 200x200 (bis zu 80x80 Pixel )
  • thumbnailIndex Beschreibt, in welchem Umfang Screenshots der Startseite genutzt werden dürfen.

  • unlimited (Beliebige Größe)
  • 120x120 (bis 120x16 Pixel)
  • ...
  • 600x600 (bis zu 600x600 Pixel )
  • thumbnailArticle Beschreibt, in welchem Umfang Screenshots eines Artikels genutzt werden dürfen.

  • unlimited (Beliebige Größe)
  • 120x120 (bis 120x16 Pixel)
  • ...
  • 600x600 (bis zu 600x600 Pixel )
  • linkTitleLength Gibt an, wie viele Zeichen eines Titels beim Verlinken auf die Webseite oder einen Artikel verwendet werden dürfen.

  • unlimited (Der ganze Titel darf übernommen werden)
  • 150 (bis zu 150 Zeichen dürfen übernommen werden)
  • 300 (bis zu 300 Zeichen dürfen übernommen werden)
  • snippetLength Gibt an, wie viele Zeichen Umgebungtext für ein Snippet verwendet werden dürfen.

  • unlimited (Der komplette Text darf übernommen werden)
  • 150 (bis zu 150 Zeichen dürfen übernommen werden, entspricht Google-Suche)
  • 250 (bis zu 250 Zeichen dürfen übernommen werden, entspricht Google-News)
  • 350 (bis zu 250 Zeichen dürfen übernommen werden, entspricht Facebook Timeline)
  • 500 (bis zu 500 Zeichen dürfen übernommen werden)
  • iFrame Gibt an, ob Dritte Inhalte der Webseite in einem Iframe einbinden dürfen

  • yes
  • no
  • fullText Gibt an, in welchen Fällen eine Volltext-Freistellung von Inhalten der Webseite gestattet ist. Eine Kombination der Folgenden Werte ist möglich:

  • mobility (wenn es der Lesbarkeit auf mobilen Endgeräten dient)
  • usability (zur besseren Nutzbarkeit der Inhalt, beispielsweise Copy&Pase)
  • accessibility (aus Gründen der Barrierefreiheit, Lesbarkeit für Behinderte Menschen)