Create Zone placement

Create Zone placement

POST https://api.ocamba.com/v2/adex/zones/{id}/placements
Creates a new Zone placement object

Info
Placements are only available on display zones.

Rate limits:

  • Burst: 10/s
  • Steady: 150/m

Path parameters

parameters

Request schema

body

Response schemas

curl -X POST \
 "https://api.ocamba.com/v2/adex/zones/{id}/placements" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "TOP_LEFT",
  "name": "My first placement",
  "description": "Here goes description.",
  "layouts": [
    [
      "banner"
    ]
  ],
  "conf": {}
}'
const url = 'https://api.ocamba.com/v2/adex/zones/{id}/placements';
const options = {
  method: 'POST',
  headers: {
    Authorization: "Bearer {TOKEN}",
    'Content-Type': "application/json"
  },
  body: JSON.stringify(
    {
      "id": "TOP_LEFT",
      "name": "My first placement",
      "description": "Here goes description.",
      "layouts": [
        [
          "banner"
        ]
      ],
      "conf": {}
    }
  )
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
$ch = curl_init("https://api.ocamba.com/v2/adex/zones/{id}/placements");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer {TOKEN}",
  "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(
  [
    "id" => "TOP_LEFT",
    "name" => "My first placement",
    "description" => "Here goes description.",
    "layouts" => [
      [
        "banner"
      ]
    ],
    "conf" => []
  ]
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Responses

201 Created

{
  "id": "TOP_LEFT",
  "company_id": "1000000",
  "zone_id": "1000001",
  "track_id": "AF6PgAAtzeU",
  "tag": "<div class=\\\"axocmba\\\" data-slot=“feed.feed-name.com/AF6PgAAtzeU/l1”></div>",
  "name": "My first placement",
  "description": "Here goes description.",
  "layouts": [
    [
      "banner"
    ]
  ],
  "unit_size": [
    "300x250"
  ],
  "conf": {
    "wrap": "iframe",
    "js_code_exec": 1
  },
  "create_time": "2022-10-29 12:47:00",
  "update_time": "2022-10-30 14:27:26"
}

400 Bad Request

{
  "code": 400,
  "title": "Bad request.",
  "message": "The request is not valid.",
  "trace_id": "99a84211-f73d-4ff8-acdf-eb3e06bb9d62"
}

500 Internal Server Error

{
  "code": 500,
  "title": "Internal server error.",
  "trace_id": "99a84211-f73d-4ff8-acdf-eb3e06bb9d62"
}
Responses