startparadies.de Board | Druckvorschau: Start des Betatest unserer neuen SP-API für externe Seiten

Geschrieben von unknown am 24.03.2005 um 20:14:

Achtung

Start des Betatest unserer neuen SP-API für externe Seiten

Hallo,

in kürze wird die neue SP-API im Betatest starten.

Wir bieten mindestens den ersten 100 Webmastern, welche ausschließlich auf Basis von eSPeros ein Projekt aufbauen wollen, folgendes Sponsoring an:
- kostenloser Webspace für 1 Jahr
- Startguthaben von 100000 eSPeros
(Bedingung, der Webspace muss zu mindestens 90% für das eSPero-Projekt genutzt werden).

Um denen unter Euch, welche die API nutzen möchten, eine Möglichkeit zu geben sich bereits darauf vorzubereiten, hier eine kurze Erläuterung zu unserer SP-API.

Unsere API arbeitet im Prinzip ähnlich zu anderen API's/Interfaces.

Folgende Features bietet unsere SP-API.
Grundsätzlich werden alle Buchungen intern durch eine CheckID zusätzlich geprüft. Dies bedeutet, nur wenn eine Buchung wirklich korrekt durchgeführt wurde, erhaltet Ihr auch den entsprechenden Responsecode für OK zurück.
Zusätzlich kann jede Buchung durch eine eigene, mitgelieferte TransaktionsID geprüft werden.

Wir werden bei der SP-API mit sechs verschiedenen Dateien arbeiten.
Diese sind:
esend.php (versenden von eSPeros an einen SP-User)
eget.php (einziehen von Losen von einem SP-User)
transcheck.php (check der Transaktion(en))
esald.php (Saldoabfrage des Kontostandes eines SP-Users)
ucheck.php (Usercheck gesperrt / nicht gesperrt)
acheck.php (Kontostand, freie Anfragen und alle Transaktionen der letzten 30 Tage abrufen)
reg.php (zum Werben neuer User)

Folgende Responsecodes gibt es:
10001 OK
10002 SP-API Account existiert nicht
10003 SP-API Passwort falsch
10004 Nicht genug SP-API Anfragen verfügbar
10005 SP-API Kennung existiert nicht
10006 SP-User existiert nicht
10007 SP-User ist gesperrt
10008 SP-User hat zu wenig eSPeros
10009 UserPasswort falsch
10010 Zu wenig eSPeros auf dem SP-API Account oder Transfer unter Mindestbetrag
10011 Anzahl nicht zulässig
10012 Betreff nicht zulässig
10013 Fehler bei der Durchführung der Buchung
10014 Fehler bei der Buchung (action fehlt)
10015 API-ID,UserID,Anzahl und TransaktionsID müssen numerisch sein
10016 Variablen für diese Aktion fehlen
10089 Transaktions-Code nicht vorhanden
10098 SP-API Account ist gesperrt
10099 Unbekannter Fehler
11001 Buchung korrekt durchgeführt (bei transcheck.php)

Folgende Variablen stehen zur Verfügung:
act action
aid SP-API AccountID
apw SP-API Passwort
uid UserID
upw UserPWD
anz Anzahl eSPeros
be Betreff
tid eigene TransaktionsID
ken Kennung (folgt später)

Solltet Ihr mit einem Formular arbeiten in dem User selber einen Betreff eintragen können, empfehlen wir aus Sicherheitsgründen mit urlencode() zu arbeiten.
Der Code könnte dann in etwa so aussehen:

code:
1: 2:	$subjekt = urlencode("$_POST[betreff]"); $url = "http://www.startparadies.de/spapi/test1.php?aid=ID&apw=PWD&uid=USERID&anz=ANZAHL&tid=IhreID&be=$subjekt";

Für das Auslesen der Responscodes könnt Ihr z.B. einen Code wie diesen nutzen:
z.B.

code:

1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
11:

$subjekt = urlencode("$_POST[betreff]");
$url = "http://www.startparadies.de/spapi/esend.php?aid=ID&apw=PWD&uid=USERID&anz=ANZAHL&tid=IhreTransID&be=$subjekt"; 
$fp=@fopen("$url","r");
if($fp){
   while($line=fgets($fp,1000)){
   $file.=$line;
   }
   fclose($fp);
}

Zwingend nötig für das Senden von eSPeros (also vom API-Account zu einem User sind die Variablen:
aid = API-ID (zwingend numerisch)
apw = API-Passwort
uid = Userid des Empfängers (zwingend numerisch)
anz = Anzahl (zwingend numerisch)
Alternativ ist noch möglich:
tid = eigene TransaktionsID (zwingend numerisch)
be = Betreff bis zu 40 Zeichen

Der Aufruf könnte also wie folgt aussehen:

code:
1: 2: 3:	http://www.startparadies.de/spapi/esend.php?aid=ID&apw=PWD&uid=USERID&anz=ANZAHL&tid=IhreTransID&be=$subjekt

Für den Einzug von eSPeros (also vom User auf den API-Account) ist zwingend erforderlich:
aid = API-ID (zwingend numerisch)
apw = API-Passwort
uid = Userid von wo abgebucht werden soll (zwingend numerisch)
upw = API-Passwort des User
anz = Anzahl (zwingend numerisch)
Alternativ ist noch möglich:
tid = eigene TransaktionsID (zwingend numerisch)
be = Betreff bis zu 40 Zeichen

ein Aufruf könnte also wie folgt aussehen:

code:
1: 2: 3:	http://www.startparadies.de/spapi/eget.php?aid=ID&apw=PWD&uid=USERID&upw=USERPWD&anz=ANZAHL&tid=IhreTransID&be=$subjekt

Die transcheck.php (check der Transaktion(en))
esald.php (Saldoabfrage des Kontostandes eines SP-Users)
ucheck.php (Usercheck gesperrt / nicht gesperrt)
acheck.php (Kontostand, freie Anfragen und alle Transaktionen der letzten 30 Tage abrufen) werden wir die nächste Zeit noch einbauen.

Für die API ist ein getrenntes Konto nötig, welches auch getrennt geführt wird. Eine Anmeldung direkt aus dem Memberbereich heraus wird es nach dem Betatest geben. Während des Betatest werden die Accounts manuell angelegt.

Und jetzt noch etwas in eigener Sache
Natürlich ist die API nur dann sinnvoll wenn sich dadurch externe Seiten bilden und entwickeln.
Aus dem Grund werden wir die erste Zeit sämtliche Seiten, welche ausschließlich eSPeros nutzen, unterstützen.
Dies beginnt z.B. bei Unterstützung bei der Umsetzung und geht aber noch viel weiter.
Wir bieten mindestens den ersten 100 Webmastern, welche ausschließlich auf Basis von eSPeros ein Projekt aufbauen wollen, folgendes Sponsoring an:
- kostenloser Webspace für 1 Jahr
- Startguthaben von 100000 eSPeros
(Bedingung, der Webspace muss zu mindestens 90% für das eSPero-Projekt genutzt werden).

Weiterhin werden wir, nach der Betatestphase unter allen Webseiten 3 und wenn die Aktion sehr gut läuft sogar 6 Ista-Slots (ich denke die meisten werden diese kennen und auch wissen was diese kosten Augenzwinkern

) vergeben!

Zusätzlich suchen wir noch Programmierer welche Games/Scripte auf Basis der SP-API (um)programmieren und verkaufen möchten.
Den ersten 5 Programmierern - welche sich hier im Thread melden - bieten wir einen exclusiven Link zu Ihrem Websop in unserem SP-API- und eSPero-Bereich für 12 Monate an. Wer also einer der ersten sein und von dem "neuen Markt" profitieren möchte sollte schnell sein Augenzwinkern

Voraussetzung hierfür ist natürlich, dass der Webshop auch eSPeros akzeptiert.

Weiterhin werden wir hier sämtliche Seiten, welche eSPeros akzeptieren, auch in einem eigenen Thread listen.

Bei Fragen zu unserer API bitte nur hier im Thread posten.

Viele Grüße

Erweiterung vom 29.03.2005
API jetzt auch zum Userwerben verfügbar (z.B. zur Verwendung in eigenen Anmeldeformularen)
Folgende Variablen sind verfügbar:

API-Daten:
aid = API-Account
apw = API-Passwort
ref = Eure RefID

Anmeldedaten:
uname = Username
upwd = Passwort
vor = Vorname
nach = Nachname
strasse = Stasse
plz = PLZ
ort = Ort
gtag = Geburtstag (Tag des Monats)
gmonat = Geburtsmonat
gjahr = Geburtsjahr
tel = Telefon
mail = Emailadresse
agb = AGBs anerkannt (1=anerkannt 0 oder leer = nicht anerkannt)

Folgende Responsecodes gibt es (neben den bereits bekannten 10002/10098/10003/10099):
12001 Registrierung Registrierung ok
12002 Registrierung API-Zugangsdaten fehlen
12003 Registrierung Username oder Userpwd fehlt
12004 Registrierung Name, Anschrift fehlt
12005 Registrierung Email fehlt
12006 Registrierung RefID fehlt
12007 Registrierung AGBs nicht akzeptiert
12008 Registrierung schon ein Account vorhanden
12009 Registrierung Username schon vergeben

Zur Sicherheit vor Missbrauch muss ein Login mit den normalen API-Daten erfolgen.

Geschrieben von bububoomt am 24.03.2005 um 21:00:

Hört sich gut an.

Wann ist es soweit? dann bereite ich meine Seite lose-preis.de vor.
Dort sind auch schon andere Währungen eingebunden.

Geschrieben von unknown am 24.03.2005 um 22:36:

Hallo,

der Betatest kann sofort beginnen.
Ich bräuchte nur deine UserID, dann kann ich Dir einen API-Account freischalten.

Viele Grüße

Geschrieben von bububoomt am 29.03.2005 um 18:19:

hmm,

wieso habe ich denn keine benachrichtigung bkommen?? *edit* weils nicht eingestellt war smile

*editende*

naja

2414 ist meine id...

Geschrieben von unknown am 29.03.2005 um 19:05:

Hallo,

Du kannst seit dem WE den API-Account im Memberbereich selber freischalten smile

Viele Grüße

Geschrieben von bububoomt am 30.03.2005 um 00:53:

Soweit so gut, habe es auch schon eingebunden, funktioniert aber net, weil:

wo finde ich mein api pw??? habe alles schon durchsucht, finde es aber net unglücklich

Habe es mir meinem normalen PW versucht, aber des stimmt net unglücklich

Geschrieben von unknown am 30.03.2005 um 01:24:

Hallo,

aktuell ist das PWD für die API noch identisch zum PWD für Deinen Useraccount hier. Die PWD-Änderung mach ich aber noch rein, so dass man zwei getrennte PWDs nutzen kann.

Viele Grüße

Geschrieben von bububoomt am 30.03.2005 um 01:39:

bekomme die fehlermeldung

Fatal error: Call to undefined function: betreffcheck() in /home/startparadies_de/www/spapi/eget.php on line 32

bei send das gleiche

Geschrieben von unknown am 30.03.2005 um 01:49:

ups, da habe ich beim Einbau der neuen Funktion für User werben etwas geändert, geht in zwei Minuten wieder smile

[edit] geht wieder Augenzwinkern

[/edit]

Geschrieben von bububoomt am 30.03.2005 um 01:56:

und ich dachte schon, heute will gar nix mehr bei mir funktionieren...

dann bin ich ja gespannt obs gleich funktioniert oder doch noch was dann bei mir fehlerhaft ist...

Geschrieben von unknown am 30.03.2005 um 02:00:

bei meinem test hats eben funktioniert, sollte also auch bei dir jetzt gehen Augenzwinkern

Geschrieben von bububoomt am 30.03.2005 um 02:05:

Juhu, danke

wenigstens ein lichtblick smile

Wenn ich das mit den cc-miles noch hinbekomme smile

Somit gibt es eine Seite mehr, bei der man eure währung nutzen kann smile

www.lose-preis.de

Geschrieben von unknown am 30.03.2005 um 02:13:

Prima smile

Die Seite wurde mit in die Liste aufgenommen smile

Geschrieben von bububoomt am 30.03.2005 um 02:16:

Danke, ist schon geplant, was die Api kosten soll später??

Ich meine die 500k langen erstmal, aber ich hoffe ja sehr viele User bald zu haben, und wie das dann aussieht, weiiß keiner....

Geschrieben von unknown am 30.03.2005 um 02:22:

nun ich denke es wird, ähnlich wie auch bei anderen seiten früher, täglich 1000 freianfragen geben. ich denke diese reichen selbst bei großen seiten meistens aus.
sollte wirklich der tag kommen wo dies jemanden nicht reicht werden wir uns gedanken machen. dies wird sich dann wohl am aktuellen markt orientieren.
wobei dies mit sicherheit noch 1 jahr zeit oder mehr hat Augenzwinkern

Geschrieben von bububoomt am 30.03.2005 um 02:23:

*ironie*welche Seite meinst du bloß mit 1000 freianfragen??? */ironie*

Sollange nicht die Preise sich genau so entwickeln, wie dort, was ich ja unverschämpt finde.... smile

Geschrieben von unknown am 30.03.2005 um 02:25:

ne das denke ich nicht, denn zum einen kann ich die erklärung mit dem traffik nicht ganz nachvollziehen und zum anderen haben wir bessere traffikpreise Augenzwinkern

Geschrieben von bububoomt am 30.03.2005 um 02:28:

na dann ist ja gut...

wünsche ne gute nacht, ist ja schon spät.bis denn und noch viel erfolg mit der api

Geschrieben von cashsurfers am 29.04.2005 um 19:29:

smile

werden auch seiten unterstützt mit multi-währungen sprich mit mehreren währungen, weil ich plane mit esperos zu arbeiten biete aber weiterhin auch die bekannten währungen an.

wäre cool wenn ja großes Grinsen

Geschrieben von unknown am 30.04.2005 um 00:36:

Hallo,

nun wie geschrieben muss 90% des Projektes auf eSPerobasis laufen. Uns kostet der Webspace bzw. der Traffik ja auch Geld und das Sponsoring kann deswegen wirklich nur unter den Bedingungen erfolgen.

Viele Grüße