adtago API v1 (DEPRECATED) > GetOrders

ACHTUNG: Diese Version der API gilt als veraltert und wurde als DEPRECATED gekennzeichnet.
Bitte wechseln Sie zur neuen adtago API v2.
Mit dieser Methoden erhalten Sie alle Buchungsinformationen der von Ihnen erzielten Leads + Sales.

Request

Request-URL: http://api.adtago.de/GetOrders.php?p=[PUBLIC_KEY]&k=[MD5_FINGERPRINT]&FROM=[FROM]&to=[TO]
{ &panel=[PANEL]&marketing_id=[MARKETING_ID]&order_type=[ORDER_TYPE]&shop_id=[SHOP_ID] }

Parameter Beispiel Beschreibung
[PUBLIC_KEY] x1234y6789 adtago-Public-Key (siehe Produkte > adtago API)
[MD5_FINGERPRINT] c5s446e8cswd53s5y459wfxaqg6e2dse

Fingerprint
MD5-Fingerprint aus FROM und TO-Datum und adtago-Private-Key:
FROM#TO#adtago-Private-Key (direkt aneinander - Trennzeichen = #)


Beispiel-Code (FROM = 2026-06-10, TO= 2026-06-10)
md5("2026-06-10#2026-06-10#Xu38sV2u6ZXu38sV2u6ZXu38sV2u6Zrd")

Ergebnis:
c5s446e8cswd53s5y459wfxaqg6e2dse

[FROM] 2026-06-10 Startdatum der Abfrage
[TO] 2026-06-10 Enddatum der Abfrage

Optionale Parameter:
Parameter Beispiel Beschreibung
[PANEL] xHe2kZ32kS Werbeflächen-Hash (siehe GetPanels)
[MARKETING_ID] 1

Marketing-/Tool-ID:
1 = smartLink ClickGate
2 = smartLink DropGate
4 = adtago API

[ORDER_TYPE] S Buchungsart:
S = SALE
L = LEAD
[SHOP_ID] 100127 Shop-ID

Beispiel:
http://api.adtago.de/GetOrders.php?p=x1234y6789&k=c5s446e8cswd53s5y459wfxaqg6e2dse&FROM=2010-01-11&to=2010-01-11
{ &panel=xHe2kZ32kS&marketing_id=1&order_type=S&shop_id=100127 }


Response

Response:
<?xml version="1.0" encoding="ISO8859-1"?>
<orders>
  <order id="{9FEBA643-AA11-4405-9828-E0C66548B388}">
    <shop id="100127">Heine DE</shop>
    <panel hash="xHe2kZ32kS">adtago.de</panel>
    <marketing id="1" />
    <turnover>123,45</turnover>
    <commission>12,34</commission>
    <currency>EUR</currency>
    <order_type>S</order_type>
    <status>0</status>
    <subid>12345678</subid>
    <created>2010-01-11 12:47:45</created>
    <modified>2010-01-11 12:47:45</modified>
  </order>
  <order id="{96E4BB44-FF3F-41E8-864A-E5CA72251D8C}">
    ...
  </order>
</orders>


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>