listings¶

Creates a new listing. New listings are automatically claimed by it’s creator.

Body Parameters¶

A Listing model.

Response¶

On success returns HTTP 201 Created with the newly created Listing in the body.

On error returns an Error object.

Examples¶

Request¶

POST https://api.opendi.com/de/listings

{
    "name": "Opendi AG",
    "description": "A company full of nice people creating internet based white pages and and yellow pages.",
    "keywords": [
        "White Pages",
        "Yellow Pages",
        "Telephonenumbers",
        "Contacts",
        "Nice People"
    ],
    "address": "40 Müllerstr.",
    "zip": "80469",
    "place": "München",
    "country_code": "DE",
    "latitude": 48.1312973,
    "longitude": 11.5699438,
    "emails": [
        {
            "address": "info@opendi.com"
        }
    ],
    "phones": [
        {
            "type": "landline",
            "number": "+498001055105"
        },
        {
            "type": "landline",
            "number": "+4989189476620"
        },
        {
            "type": "fax",
            "number": "+4989189476626"
        }
    ],
    "hours": {
        "monday": [
            {
              "start": "10:00",
                "end": "17:00"
            }
        ],
        "tuesday": [
            {
                "start": "09:00",
                "end": "17:00"
            }
        ],
        "wednesday": [
            {
                "start": "09:00",
                "end": "17:00"
            }
        ],
        "thursday": [
            {
                "start": "09:00",
                "end": "17:00"
            }
        ],
        "friday": [
            {
                "start": "09:00",
                "end": "17:00"
            }
        ],
        "saturday": [],
        "sunday": []
    },
    "links": [
        {
            "type": "website",
            "url": "www.stadtbranchenbuch.com"
        },
        {
            "type": "googleplus",
            "url": "https://plus.google.com/118150864364347134043/"
        }
    ],
    "categories": [
        {
            "id": "58",
            "name": "Bestatter"
        }
    ],
    "active": true
}

Response¶

The response will have IDs populated for the listing and every submodel such as phones, links and emails. Also, it will have the the url on which the listing is viewable.

HTTP 201 Created

{
    "id": "6874671",
    "name": "Opendi AG",
    "address": "40 Müllerstr.",
    "zip": "80469",
    "place": "München",
    "country_code": "DE",
    "latitude": 48.1312973,
    "longitude": 11.5699438,
    "keywords": [
        "Contacts",
        "White Pages",
        "Yellow Pages",
        "Telephonenumbers",
        "Nice People"
    ],
    "description": "A company full of nice people creating internet based white pages and and yellow pages.",
    "emails": [
        {
            "id": "37026",
            "address": "info@opendi.com"
        }
    ],
    "phones": [
        {
            "id": "2828447",
            "type": "landline",
            "number": "+498001055105"
        },
        {
            "id": "2828448",
            "type": "landline",
            "number": "+4989189476620"
        },
        {
            "id": "2828449",
            "type": "fax",
            "number": "+4989189476626"
        }
    ],
    "url": "http://vereinigtes-koenigreich.uk-eu-staging.opendi.com/london-colney/6874671.html",
    "hours": {
        "monday": [
            {
                "start": "10:00:00",
                "end": "17:00:00"
            }
        ],
        "tuesday": [
            {
                "start": "09:00:00",
                "end": "17:00:00"
            }
        ],
        "wednesday": [
            {
                "start": "09:00:00",
                "end": "17:00:00"
            }
        ],
        "thursday": [
            {
                "start": "09:00:00",
                "end": "17:00:00"
            }
        ],
        "friday": [
            {
                "start": "10:00:00",
                "end": "12:00:00"
            },
            {
                "start": "14:00:00",
                "end": "17:00:00"
            }
        ],
        "saturday": [],
        "sunday": []
    },
    "links": [
        {
            "id": "37027",
            "type": "website",
            "url": "www.stadtbranchenbuch.com"
        },
        {
            "id": "37028",
            "type": "googleplus",
            "url": "https://plus.google.com/118150864364347134043/"
        }
    ],
    "categories": [
        {
            "id": "58",
            "name": "Mot Testing Centres"
        }
    ],
    "active": true,
    "contact": null
}