Moviepilot API Dokumentation

there is also a english version

Version: 0.2
Last updated: 2009-09-22

http://www.moviepilot.com

Table of Contents

• Ressourcetypen
  • Film
    • Filmteam
    • Ähnliche Filme
  • Person
    • Personenbilder
    • Filmografie
• Suchen
  • Personensuche
  • Filmsuche

Kontakt

Fragen zur Anwendung der API können unter api at moviepilot punkt de gestellt werden. Unter dieser Mailadresse können ebenfalls API-Keys beantragt werden. Für Fragen und Disskusionen mit anderen Nutzern gibt es eine Mailingliste.

Überblick

Die Moviepilot API ist als RESTful Webservice konzipiert.
Werden bestimmte URLs über einen GET-Request aufgerufen, werden als HTTP-Antwort JSON-Objekte
(http://json.org) zurückgeliefert. Die Anzahl und Sortierung der Antwortobjekte können über in der URL
mitgesendete GET-Parameter konfiguriert werden.

Zugriff

Bis jetzt ist nur lesender Zugriff möglich.

Antwort-Format

Die zurückgelieferten Antworten sind jeweils im Datenaustauschformat JSON mit dem
Zeichensatz UTF-8. Die Antwort ist escaped (d.h. ein Slash “/” wird als Backslash-Slash “\/” dargestellt)
und ohne Zeilenumbrüche in einer Zeile.
Es ist möglich, die Anzahl der zurückgelieferten Objekte zu begrenzen bzw. generell Paginierung zu
verwenden, indem die GET-Parameter per_page für die Anzahl der zurückzuliefernden Elemente bzw.
page gesetzt werden.
Genauere Details stehen bei der Beschreibung der einzelnen Ressourcetypen.

Authentifizierung

Die Authentifizierung erfolgt über einen API Key, der unter api@moviepilot.de erhältlich ist. Der API-Key
muss mit dem GET-Parameter &api_key=<key> bei jeder Anfrage mitgesendet werden.

Bilddaten

Für Bilder von Filmpostern oder Personen kann man sich aus Imageeigenschaften via base_url + photo_id + / + filename_base + _format + . extension die entsprechenden urls ƒür unterschiedliche Formaten zusammenfügen.