POST /adspaces/adspace

Updated on

Creates a new advertising space. See adspaceItem element definition in WSDL/XSD.

This resource requires connectid, nonce, date and signature for authentication. See Authentication documentation for REST and SOAP. Passing authentication information as query parameters for REST is supported.

Resource URL

XML: https://api.zanox.com/xml/2011-03-01/adspaces/adspace

JSON: https://api.zanox.com/json/2011-03-01/adspaces/adspace

Parameters

adspaceItem
required

the adspace item to be created.

Value Type:
Example Value:

callback
optional

Supported if format is JSON. Returns the name of the JS function the result is wrapped in.

Value Type: String
Example Value:

Example Request

REST authentication information must be included in request headers or added as query parameters

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<request>
    <adspaceItem xml:lang="en">
        <name>example.com</name>
        <url>http://www.example.com</url>
        <contact>contact@example.com</contact>
        <description>This website contains ...</description>
        <visitors>100.000</visitors>
        <impressions>5.000.000</impressions>
        <type>website</type>
        <scope>business</scope>
        <regions>
            <region>de</region>
            <region>en</region>
        </regions>
        <categories>
            <category>11</category>
            <category>12</category>
        </categories>
    </adspaceItem>
</request>

Example Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response xmlns="http://api.zanox.com/namespace/2011-03-01/">
    <adspaceItem xml:lang="en">
        <name>example.com</name>
        <url>http://www.example.com</url>
        <contact>contact@example.com</contact>
        <description>This website contains ...</description>
        <visitors>100.000</visitors>
        <impressions>5.000.000</impressions>
        <type>website</type>
        <scope>business</scope>
        <regions>
            <region>de</region>
            <region>en</region>
        </regions>
        <categories>
            <category>11</category>
            <category>12</category>
        </categories>
    </adspaceItem>
</response>

Resource Information

Rate Limited?	No
Authentication	Requires signature. See REST Authentication SOAP Authentication
Response Formats	json, xml
HTTP Methods	POST
Resource family	adspaceItems
Response Object	adspaceItem
API Version	2011-03-01