Senden
Zum senden von Netzis muss folgende URL genutzt werden:
https://www.netzis.de/api/send.ashx

Parameter:

apiid
apipw
uid
Userid des Empfängers
upw
optinal Netzis-Passwort des Users
anz
Anzahl der Netzis (int)
b
Transaktionstext max. 75 Zeichen (Urlencoded), [a-zA-Z0-9. -]
tc
optional Transaktionscode max. 75 Zeichen (Urlencoded), [a-zA-Z0-9. -]
Einziehen
Zum einziehen von Netzis muss folgende URL genutzt werden:
https://www.netzis.de/api/get.ashx

Parameter:

apiid
apipw
uid
Userid des Empfängers
upw
Netzis-Passwort des Users
anz
Anzahl der Netzis (int)
b
Transaktionstext max. 75 Zeichen (Urlencoded), [a-zA-Z0-9. -]
tc
optional Transaktionscode max. 75 Zeichen (Urlencoded), [a-zA-Z0-9. -]
tr
optional, wird tr übergeben und ist nicht leer (z.b. tr=tresor) werden die Netzis in den Tresor geschoben.
Transaktions-Check
Zum prüfen ob eine Transaktion verarbeitet wurde:
https://www.netzis.de/api/transcheck.ashx

Parameter:

apiid
apipw
tc
Transaktionscode, der beim Senden/Empfangen übergeben wurde
User-Check
Status eines Users prüfen:
https://www.netzis.de/api/usercheck.ashx

Parameter:

apiid
apipw
uid
Id des zu prüfenden Users
upw
optional Netzis-Passwort des Users
Neuer User
Neue Netzis-User auf externen Seiten müssen gemeldet werden:
https://www.netzis.de/api/neueruser.ashx

Parameter:

apiid
apipw
uid
Id des neuen Users
Kontostand abfrage durch Netzis.de
Unter Konto muss eine Url und ein Passwort angegeben werden, über welche netzis.de die Kontostände eines Users bzw. aller User abrufen kann.

Parameter:

id
Deine APIID
pw
muss unter Konto gesetzt werden
uid
Id des Users

Die Rückgabe durch die Externe-Netzis-Seite muss in folgendem Format erfolgen:

Userid|Kontostand;Userid|Kontostand;...

Wird uid übergeben ist nur der Kontostand des Users auszugeben, ohne den Parameter aller User. Kontostand aller User wird in der Regel nur einmal im Monat abgerufen.
Rückgabewerte
Folgende Rückgabewerte sind aktuell möglich. Weitere können ggf. folgen.

Senden/Empfangen:

1000
Transfer erfolgreich
1002
apiid nicht übergeben oder falsch
1003
apiipw nicht übergeben oder falsch
1004
keine Abfragen vorhanden, bitte API Abfragen aufladen
1005
1006
Userid nicht übergeben
1008
User hat nicht genügend Netzis
1009
User-netzis-Passwort falsch
1010
API hat nicht genügend Netzis
1011
Anzahl unzulässig
1012
Betreff nicht übergeben
1020
User für API nicht freigeschaltet (nur bei Empfang)
1098
apiid gesperrt


Werden b und tc übergeben werden diese gefiltert und unzulässige Zeichen entfernt. Ein Fehlercode wird nicht zurückgegeben. Nur wenn b nicht übergeben wird gibt es 1012.
Die Rückgabe:
Rückgabecode|API-Netzis Transaktionsbeginn|API-Netzis nach Transaktionende
z.B.:
1000|100|110


Transaktionscheck:

2000
Transaktion gefunden
2001
Transaktion nicht gefunden
1002
apiid nicht übergeben oder falsch
1003
apiipw nicht übergeben oder falsch
1098
apiid gesperrt
Die Rückgabe:
Rückgabecode|Datum|timestamp
z.B.:
2001|4/19/2024 4:29:51 PM|1713544191

Usercheck:

3000
User vorhanden, freigeschaltet, nicht gesperrt
3001
User nicht vorhanden
3002
User gesperrt
3003
Account nicht bestätigt
1002
apiid nicht übergeben oder falsch
1003
apiipw nicht übergeben oder falsch
1006
Userid nicht übergeben
1009
User-netzis-Passwort falsch
1098
apiid gesperrt
Die Rückgabe:
Rückgabecode

z.B.
3003

Ausnahme bei Rückgabecode 3000:
Rückgabecode|Username
z.B.:
3000|Admin|

Ausnahme bei Rückgabecode 3002:
Rückgabecode|Datum gesperrt bis|timestamp gesperrt bis
z.B.:
3002|4/19/2024 4:29:51 PM|1713544191

Neuer User:

4000
Neuer User wurde erfasst
4001
Fehler, User konnte nicht erfasst werden
4002
User bereits erfasst
1002
apiid nicht übergeben oder falsch
1003
apiipw nicht übergeben oder falsch
1098
apiid gesperrt
Die Rückgabe:
Rückgabecode

z.B.
4000