verifyAccountSecure

Verwendung:

Überprüft die eingegebenen Logindaten ob sie korrekt sind.

Beispiele:

Weiterleitung auf weitere Seiten, wenn der Login erfolgreich war. Dadurch ist eine Aussortierung möglich.

Fremdwörter:

keine

Voraussetzungen:

Voraussetzung ist ein bestehender Camheroes-Account.

Architektur:

HOST & URI

REST (Wikipedia link)

Die Anfrage sollte ausschließlich via REST stattfinden. Als Methode empfiehlt sich POST da die Logindaten übergeben werden.

HTTP Methode

POST

Authentifizierung

Hierfür werden der Username und das Passwort durch einen Doppelpunkt getrennt zu einem String zusammengeführt, das Passwort muss zunächst SHA1 verschlüsselt werden. Desweiteren müssen die Angaben base64 codiert werden.

Beispiel:

Fehlermeldung

Sollte die Anfrage fehlerhaft sein, so erhält man als XML-Antwort einen Status 0.

Beispiel:

<?xml version="1.0" encoding="utf-8" ?>
  <request>
    <status>0</status>
  </request>
  ...

Server-Antwort (erfolgreich):

<?xml version="1.0" encoding="utf-8" ?>
  <request>
    <status>1</status>
  </request>

Server-Antwort (fehlerhaft):

<?xml version="1.0" encoding="utf-8" ?>
  <request>
    <status>0</status>
  </request>

---

uploadSecure

Verwendung:

Lädt angegebene Bilder auf Camheroes und ordnet diese dem angegebenen Camheroes-Account hinzu.

Beispiele:

Einbinden eines Upload-Formulares auf verschiedenen Plattformen.

Fremdwörter:

keine

Voraussetzungen:

Voraussetzung ist ein bestehender Camheroes-Account.

Architektur:

REST (Wikipedia link)

Die Anfrage sollte ausschließlich via REST stattfinden. Als Methode empfiehlt sich PUT oder POST da das Bild sowie die Logindaten gesendet werden.

HTTP-Methode

PUT or POST

Authentifizierung

Hierfür werden der Username und das Passwort durch einen Doppelpunkt getrennt zu einem String zusammengeführt, das Passwort muss zunächst SHA1 verschlüsselt werden. Desweiteren müssen die Angaben base64 codiert werden.
Das jeweilige Bild muss binär übersendet und als Attachement mit dem Namen "uploadfile" und dem Dateinamen "iphone.jpg" angefügt werden. Diese Angaben können über Content-Disposition im HTTP Header vorgenommen werden.

Beispiel:

Fehlermeldung

Sollte die Anfrage fehlerhaft sein, so erhält man als XML-Antwort einen Status 0.

Beispiel:

<?xml version="1.0" encoding="utf-8" ?>
  <request>
    <status>0</status>
  </request>
  ...

Server-Antwort (erfolgreich):

<?xml version="1.0" encoding="utf-8" ?>
  <request>
    <status>1</status>
  </request>

Server-Antwort (fehlerhaft):

<?xml version="1.0" encoding="utf-8" ?>
  <request>
    <status>0</status>
  </request>

---

myLatestImages

Verwendung:

Gibt die letzten, öffentlichen Bilder seines Camheroes-Accounts aus.

Beispiele:

Einbinden der Ausgabe auf verschiedenen Plattformen.

Einbinden in verschiedene Webseiten (Bspw. Wordpress, etc.).

Fremdwörter:

keine

Voraussetzungen:

Voraussetzung ist ein bestehender Camheroes-Account sowie hochgeladene Bilder.

Architektur:

REST (Wikipedia link)

Die Anfrage sollte ausschließlich via REST stattfinden. Als Methode empfiehlt sich GET.

HTTP-Methode

GET

LIMIT

Das Maximum-Limit der Ausgabe liegt derzeit bei 25 Bildern.

Authentifizierung

Hierfür werden der Username und das Passwort durch einen Doppelpunkt getrennt zu einem String zusammengeführt, das Passwort muss zunächst SHA1 verschlüsselt werden. Desweiteren müssen die Angaben base64 codiert werden.

Beispiel:

Fehlermeldung:

Sollte die Anfrage fehlerhaft sein, so erhält man als XML-Antwort einen Status 0.

Beispiel:

<?xml version="1.0" encoding="utf-8" ?>
  <request>
    <status>0</status>
  </request>

Server-Antwort (erfolgreich):

<?xml version="1.0" encoding="utf-8" ?>
  <request>
    <status>1</status>
  </request>
  <images>
    <image>
      <thumbnail>http://user.camheroes.de/uplo..</thumbnail>
      <smallimage>http://user.camheroes.de/uplo..</smallimage>
      <originalimage>http://user.camheroes.de/uplo..</originalimage>
      <imagelink>http://user.camheroes.de/picture/587</imagelink>
      <uploadtime>2009-01-17 12:01:09</uploadtime>
      <uploadmode>iPhone</uploadmode>
      <timezone>Europe/Berlin</timezone>
      <description>Mein Freund und ich im Urlaub</description>
      <comments>
        <comment>
          <user>floeH</user>
          <message>Das Bild ist aber schön</message>
          <time>2009-01-17 14:01:09</time>
          <timezone>Europe/Berlin<timezone>
        </comment>
        <comment>
          <user>exrevel</user>
          <message>Wo warst du denn da?</message>
          <time>2009-01-17 13:25:50</time>
          <timezone>Europe/Berlin<timezone>
        </comment>
      </comments>
    </image>
    <image>
      <thumbnail>http://user.camheroes.de/uplo..</thumbnail>
      <smallimage>http://user.camheroes.de/uplo..</smallimage>
      <originalimage>http://user.camheroes.de/uplo..</originalimage>
      <imagelink>http://user.camheroes.de/picture/587</imagelink>
      <uploadtime>2009-01-16 12:01:09</uploadtime>
      <uploadmode>iPhone</uploadmode>
      <timezone>Europe/Berlin</timezone>
      <description>Mein Hund und ich</description>
      <comments>
      </comments>
    </image>
  </images>

Server-Antwort (fehlerhaft):

<?xml version="1.0" encoding="utf-8" ?>
  <request>
    <status>0</status>
  </request>