adtago API v1 (DEPRECATED) > ClickGate

ACHTUNG: Diese Version der API gilt als veraltert und wurde als DEPRECATED gekennzeichnet.
Bitte wechseln Sie zur neuen adtago API v2.

Dieser Methode prüft ob zu einer übergebenen URL ein Affiliate-Programm existiert und löst im Erfolgsfall das entsprechende Tracking aus. In jedem Fall (also auch wenn kein Affiliate-Programm existiert) erfolgt eine Weiterleitung zur angegebenen URL. In einigen Fällen erfolgt die Weiterleitung über eine Zwischenseite ("Splash-Screen"/Weiterleitungsseite) die maximal 2 Sekunden angezeigt wird. Die Zwischenseite ist notwendig um das Tracking auszulösen. Unser System erkennt automatisch ob diese Seite nötig ist und zeigt diese nur bei Bedarf an.

Request

Request-URL: http://api.adtago.de/ClickGate.php?p=[PUBLIC_KEY]&k=[MD5_FINGERPRINT]{&s=[SUBID]}&url=[URL] { &q=[SEARCH_QUERY] }

Parameter	Beispiel	Beschreibung
[PUBLIC_KEY]	x1234y6789	adtago-Public-Key (siehe Produkte > adtago API)
[MD5_FINGERPRINT]	c5s446e8cswd53s5y459wfxaqg6e2dse	Fingerprint MD5-Fingerprint aus URL und adtago-Private-Key: (unkodierte) URL + adtago-Private-Key (direkt aneinander - ohne Trennzeichen!) Beispiel-Code (URL = http://www.otto.de) md5("http://www.otto.deXu38sV2u6ZXu38sV2u6ZXu38sV2u6Zrd")
[SUBID]	12345	SubID (OPTIONAL) Ein beliebiger Wert der bei einer Buchung hinterlegt wird. SubIDs dürfen alphanummerisch sein (A-Z und 0-9) und als einzigen Sonderzeichen "-" beinhalten. Die maximale Länge beträgt 20 Zeichen.
[URL]	http%3A%2F%2Fwww.otto.de	URL (URL-kodiert) Beispiel-Code: urlencode("http://www.otto.de")
[SEARCH_QUERY]	M%FCnchen	Such-Query (URL-kodiert) Rein optionaler Parameter, nur für Partner aus dem Bereich Search nötig. Weitere Informationen auf Anfrage.

Beispiel:
http://api.adtago.de/ClickGate.php?p=x1234y6789&k=c5s446e8cswd53s5y459wfxaqg6e2dse&s=12345&url=http%3A%2F%2Fwww.otto.de&q=M%FCnchen

Response

Response bei erfolgreicher Authentifizierung:

Weiterleitung auf die Zielseite

Errors

Code	Meldung	Beschreibung
1000	Insufficient arguments	Mindestens ein Request-Parameter ist leer oder falsch
1001	Unknown API-User	Der adtago-Public-Key ist unbekannt (Parameter "p")
1002	Wrong MD5-Verification	MD5-Verifizierungscode ist falsch (Parameter "k")
1003	API-Quota exceeded	Das maximal verfügbare Abruf-Kontingent für die adtago-API wurde überschritten (Standard = 30.000 Calls). Das Kontingent wird monatlich zurückgesetzt. Falls Sie ein größeres Kontingent benötigen, teilen Sie uns bitte mit wie und wo Sie unsere API verwenden möchten.
1004	To many TLD (max. 20)	Es wurden zu viele Top-Level-Domains übergeben. Pro Call dürfen maximal 20 TLDs übergeben werden.
1005	Wrong request argument: ##ERROR_MSG##	Ein oder mehrere Abfrage-Parameter sind falsch (z.B. falsche Datumsangabe). In ##ERROR_MSG## werden die falschen Angabe aufgezählt.

Beispiel-Error:

<?xml version="1.0"   encoding="ISO8859-1"?>

						<error>

						  <code>1000</code>

						  <msg>Insufficient arguments</msg>

						</error>