1. #1
    Avatar von DMW007
    Registriert seit
    15.11.2011
    Beiträge
    6.080
    Thanked 9.118 Times in 2.995 Posts
    Blog Entries
    5

    Standard [Release] U-Hacks API

    Was ist eine API?

    Eine API ist eine Schnittstelle, die Programmierern die Integration von U-Hacks in eigene Software erleichtern soll.
    In diesem Fall geht es konkret um die validierung von Zugangsdaten und das auslesen diverser Nutzerinfos wie Beiträge, erhaltene Danke etc.


    Wie nutze ich die U-Hacks API?

    Einfach einen HTTP POST-Request an http://u-hacks.net/api.php mit den Parametern u für den Username und p für das md5 gehashte Passwort senden.

    Code:
    Methode: POST
    URL: http://u-hacks.net/api.php
    Content-Parameter:
    u => Benutzername
    p => Passwort (MD5 gehasht)
    Beispiel eines validen Requests mit dem Username test und dem Passwort 123

    Code:
    POST /api.php HTTP/1.1
    Host:u-hacks.net
    User-Agent:API
    Content-Type:application/x-www-form-urlencoded
    
    u=test&p=202cb962ac59075b964b07152d234b70
    Die Ausgabe erfolgt als XML im Hauptknoten root.
    Mögliche Ausgabewerte:

    Spoiler:

    status: Integer - Bei erfolgreicher Abfrage = 0
    errorcode: Nur vorhanden wenn status != 0 - Mithilfe des Errorcodes kann die genaue Fehlerursache festgestellt werden.
    Mögliche Werte:
    1 => Kein Username angegeben
    2 => Kein Passwort angegeben
    3 => Passwort falsch
    4 => Zuviele falsche Passwörter
    username: String
    userid: Integer
    Usergroupid: Integer
    thanks_rec: Integer - Gibt die Anzahl der Danke an, die der User erhalten hat
    regdate: Unix-Timestamp
    lastvisit: Unix-Timestamp
    lastpost: Unix-Timestamp

    Liste aller derzeit vorhandenen Benutzergruppen:

    Spoiler:

    Gäste: 1
    Registrierte Benutzer: 2
    Registrierte Benutzer die ihren Account noch per E-Mail bestätigen müssen: 3
    Registrierte Benutzer die auf Freischaltung durch einen Teamler warten: 4
    Globale Moderatoren: 5
    Administratoren: 6
    Moderatoren: 7
    Gesperrte Benutzer: 8
    Technische Administratoren: 9
    Entwickler: 10
    Tauschüberwacher: 11
    Redakteure: 12
    Premium-Mitglieder: 13
    3rd Level: 15
    Permanent Gesperrt: 17
    2nd Level: 19



    Gibt es auch Beispiele?

    C#

    Die Klasse UHAPI.cs bietet bequemen Zugriff auf alle möglichen Rückgabewerte der API.
    Sie kann zusammen mit einem kleinen Sample hier heruntergeladen werden:

    Download UHAPI.cs + Sample: UHAPI_CSharp_Sample.rar

    Samples für weitere Sprachen werden demnächst noch folgen.
    Grundsätzlich ist die Nutzung der API mit jeder Programmiersprache möglich, die Websockets unterstützt.


    Hinweise zur Nutzung

    Die API sollte sinnvoll eingesetzt werden.
    Bei Abfragen nach der Anzahl der Beiträge sollte man auch immer an das Spamaufkommen denken.
    Hier bietet es sich an weitere Faktoren wie Beispielsweise die Registrierungszeit oder die Anzahl der erhaltenen Danke mit einzubeziehen, um Spam zu vermeiden.

    Möchte man den Zugriff durch eine Authentifizierung über U-Hacks schützen, sollte man auch den Sicherheitsaspekt bedenken.
    Reine Abfragen nach dem Schema

    Code:
    if(posts > 50) {
         mainForm.show();
    }else {
         Environment.Exit(0);
    }
    können sehr leicht gepatcht werden.
    Zumal sich Sprachen wie .NET oder Java schon von Haus aus vergleichsweise einfach reversen und manipulieren lassen.


  2. The Following 16 Users Say Thank You to DMW007 For This Useful Post:

    AmJano (14.11.2012), Comu (15.11.2012), Dbzfreak1337 (14.11.2012), DnL (15.11.2012), Fif (16.11.2012), Gangstersheep (15.11.2012), Gurke (17.11.2012), milchbubix (15.11.2012), Mr. White (15.11.2012), Mr.Bombastic (16.11.2012), patlux (03.07.2013), Pwned (14.11.2012), Raumi (15.11.2012), rVs14 (20.11.2012), Sky.NET (14.11.2012), uncopyable (14.11.2012)

  3. #2
    Avatar von DMW007
    Registriert seit
    15.11.2011
    Beiträge
    6.080
    Thanked 9.118 Times in 2.995 Posts
    Blog Entries
    5

    Standard AW: [Release] U-Hacks API

    In der letzten Zeit gabs Probleme mit der API. Funktioniert nun wieder alles wie bisher.


  4. The Following 6 Users Say Thank You to DMW007 For This Useful Post:

    Darkfield (15.07.2013), Dbzfreak1337 (14.07.2013), Gangstersheep (14.07.2013), patlux (14.07.2013), Snees (14.07.2013), svN (16.02.2014)

Ähnliche Themen

  1. [Release] U-IMG | U-Labs Imagehoster
    Von DMW007 im Forum News und Ankündigungen
    Antworten: 1
    Letzter Beitrag: 27.06.2021, 22:32
  2. [Release] U-Hacks Downloadbase
    Von DMW007 im Forum News und Ankündigungen
    Antworten: 2
    Letzter Beitrag: 21.11.2013, 23:35
  3. [RELEASE] U-Hacks Radioplayer
    Von Pwned im Forum Showroom
    Antworten: 4
    Letzter Beitrag: 02.04.2013, 22:16
  4. [Release] U-Hacks Tauschüberwachersystem
    Von DMW007 im Forum News und Ankündigungen
    Antworten: 0
    Letzter Beitrag: 25.03.2013, 14:52
  5. [Release] U-Hacks Telefonbomber
    Von DMW007 im Forum Showroom
    Antworten: 8
    Letzter Beitrag: 24.01.2012, 20:48

Stichworte

Diese Seite nutzt Cookies, um das Nutzererlebnis zu verbessern. Klicken Sie hier, um das Cookie-Tracking zu deaktivieren.