Integration & Setup

  2. Home
  4. Integration & Setup
  6. Entwickler APIs
  8. Externe Erstellung Test-Accounts
  10. Externe Anlage Test-Accounts

Externe Anlage Test-Accounts

Für die externe Anlage eines etracker Test-Accounts muss beim Absenden des Partner-Formulars (oder beim entsprechenden Auslöser auf der Partnerseite) ein JSON-Objekt dynamisch mit Werten gefüllt und an etracker gesendet werden. Das folgende Beispiel zeigt die Übergabe der Variablen, die mindestens übergeben werden müssen.

Übergabe der Variablen 

{
 "url": "http://www.test.de",
 "email": "test@test.de",
 "firstname": "TEST",
 "lastname": "TEST2",
 "commercial": "business",
 "company": "TEST GmbH",
 "packageId": 139,
 "additionalPackageId": 150,
 "partnerId": 1111,
 "dryrun": "false"
}

Es wird im etracker Backend-System ein Test-Account mit den Produkten “etracker Analytics Enterprise Edition“ und „etracker Optimiser Enterprise Edition“ angelegt. Der Test-Account wird dem Partner mit der von Ihnen angegebenen ID zugeordnet. Die generierte Account-ID und ein Link für die Passwort-Vergabe werden automatisch an die übergebene E-Mail-Adresse, hier test@test.de, gesendet.

JSON-Objekt senden

Das JSON-Objekt muss per POST-Methode an folgende URL und Benutzernamen gesendet werden: URL: https://application.etracker.com/api/v6/accounts Benutzername: den benötigten Basic Authentication Benutzernamen erhalten Sie von Ihrem Account Manager.

Test-Account Erstellung mit ‚RESTClient‘

Die erfolgreiche Übergabe der Parameter für einen Test-Account kann mit dem ‚RESTClient‘-Plugin für Firefox komfortabel getestet werden (https://addons.mozilla.org/de/firefox/addon/restclient/ ). Diese Eingaben sind hierfür notwendig:

1. Die Methode ‚Post‘ auswählen und die o.g. URL angeben:

2. Der zu verwendende Header im Plugin ist der o.g. Benutzername

3. Das JSON-Objekt in den Body des Plugins einfügen: Z. B. die minimale Übergabe an Variablen

Alle möglichen Variablen im JSON-Objekt

Folgende Informationen können bei der Erstellung eines Test-Accounts neben den Pflichtvariablen an etracker übergeben werden: 

{
  "url": "string",
  "email": "string",
  "firstname": "string",
  "lastname": "string",
  "email-billing": "string",
  "commercial": 0,
  "company": "string",
  "sex": 0,
  "street": "string",
  "zip": "string",
  "city": "string",
  "phone": "string",
  "country": "string",
  "taxnr": "string",
  "service-period": 0,
  "accounting-period": 0,
  "packageId": 0,
  "additionalPackageId": 0,
  "paymethod": "string",
  "partnerId": 0,
  "dryrun": "string"
}

Falls die optionalen Parameter nicht gefüllt werden, müssen Default-Werte gesetzt oder die Variable weggelassen werden. Hier eine Darstellung aller möglichen Parameterwerte. 

{
url (string),
email (string), "Please enter a valid mail address, maxlength 150"
firstname (string),
lastname (string),
email-billing (string, optional), "Please enter a valid mail address, maxlength 150"
commercial (integer, optional):
[undefined, private, business] - param company must only be filled when
commercial=business ,
company (string, optional),
sex (integer, optional):
[male, female] ,
street (string, optional),
zip (string, optional),
city (string, optional),
phone (string, optional),
country (string, optional), "country maxlength=2, ISO 3166 Codes ALPHA-2 http://de.wikipedia.org/wiki/ISO_3166"
taxnr (string, optional),
service-period (integer, optional):
[1, 3, 12] ,
accounting-period (integer, optional):
[1, 3, 12] ,
packageId (integer):
additionalPackageId (integer, optional):
paymethod (string, optional):
[bill, paypal, creditcard] ,
partnerId (integer):
partner id ,
dryrun (string, optional):
[true, false]
}