listing/order (POST)

Ressourcen-Pfad

/api_rst/v2/listing/order

http://www.yellowmap.de/api_rst/v2/listing/order

Beschreibung

Ein Listing eintragen.

Parameter

Name Beschreibung Datentyp
listing [erforderlich] Listing
access [erforderlich] Access
addition Parameter, über den zusätzliche Angaben übergeben werden können (nur sinnvoll unter bestimmten
Bedingungen).
Bei Bedarf teilen wir Ihnen die notwendigen Übergabeparameter mit: Kontakt 		string

Request Header

Name Beschreibung
Authorization Siehe Autorisierung

Rückgabe (application/json)

Der Rückgabecontainer ist vom Typ SearchListingResponse.

Beispiel

Codebeispiel: listing/order (POST)

<html>
   <script src="https://code.jquery.com/jquery-1.11.1.min.js"></script>
   <script>
      $.ajax(
      {
      "listing": {
         "id": "",
         "partnerId": "hc9173c91283c",
         "description": "testDescription",
         "address": {
            "addressType": "PRIMARY_ADDRESS",
            "isoCountryCode": "DE",
            "district": "testDistrict",
            "zip": "76131",
            "city": "Karlsruhe",
            "cityPart": "Oststadt",
            "street": "Veilchenstr.",
            "houseNo": "5",
            "postBox": "testPostBox",
            "geoPosition": {
               "point": {
                  "lat": "49.010606",
                  "long": "8.428368"
               },
               "coordFormat": "GEODECIMAL_POINT"
            },
            "name": "testAddressName",
            "companyName": "testCompanyName",
            "companyAddon1": "testCompanyAddon1",
            "companyAddon2": "testCompanyAddon2",
            "openingDays": [{
               "day": "mon",
               "openingHours": [{
                  "from": "1000",
                  "till": "1200",
                  "exceptionDate": null
               },
               {
                  "from": "1400",
                  "till": "1600",
                  "exceptionDate": null
               }]
            },
            {
               "day": "tue",
               "openingHours": [{
                  "from": "1200",
                  "till": "1300",
                  "exceptionDate": null
               }]
            }],
            "openingHoursText": "testOpeningHoursText"
         },
         "contact": {
            "contactType": "PRIMARY_CONTACT",
            "emails": [{
               "address": "test@test.de",
               "display": "test@test.de"
            },
            {
               "address": "test2@test.de",
               "display": "test2@test.de"
            }],
            "phoneNumbers": [{
               "number": "123456",
               "phoneType": "PHONE"
            },
            {
               "number": "123456",
               "phoneType": "FAX"
            }],
            "urls": [{
               "address": "www.test.de",
               "display": "www.test.de",
               "urlType": "HOMEPAGE"
            },
            {
               "address": "www.test.de",
               "display": "www.test.de",
               "urlType": "HOMEPAGE"
            }]
         },
         "branches": [{
            "id": "Y090010016",
         }]
      },
      "isoLocale": "de-DE",
      "localIsoCountryCode": "DE",
      "access": {
         "username": "USER_NAME",
         "password": "RESTRICTION_KEY"
      }
   }
      ).done(function(data) {
         alert(data);
         });
   </script>
</html>

Fehler

Fehler sind vom Typ ErrorResponse.

Fehlercode Beschreibung
400
BAD REQUEST, die Anfrage wurde falsch gestellt.
401
UNAUTHORIZED, ungültige Kombination aus systemPartner und securityId.
403
FORBIDDEN, systemPartner und securityId sind korrekt, aber der Zugriff auf die gewünschten Daten ist nicht
erlaubt.
404 NOT FOUND
409 CONFLICT, ein Listing mit dieser Partner-ID existiert bereits. Bitte aktualisieren Sie das Listing stattdessen über ein PUT.
451  
500 SERVER ERROR, es ist etwas Unvorhergesehenes eingetreten.
Bitte setzen Sie sich mit uns in Verbindung: Support