Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The budget API allows publishers to discover what advertisers have budget available at a particular moment in time by making accessible a report, generated on demand of the advertisers and budgets available.

...

HTTPS Endpoint

The following endpoint is used with HTTP HTTPS GET:

...

Accessing this API requires keeping a persistent HTTP HTTPS connection open. This involves thinking about your client application differently than if you are using a REST API. In other words, use this API as a separate process independent of user requests.

...

To connect to the Discovery API, form an HTTP HTTPS request and download the response file. You must keep the connection open while you are downloading the file. This may be different for every language or framework.

...

Code Block
langhtml
Client: (Using HttpClient, Framework independent)

String endpoint = " httphttps://stream.api.citygridmedia.com/ads/budget/v2/discover?publisher=test&format=xml";
HttpGet httpGet = new HttpGet(endpoint);
HttpClient client = new DefaultHttpClient();
HttpContext context = new BasicHttpContext();
HttpResponse getResponse = client.execute(httpGet, context);
if (getResponse.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
  int size = -1;
  OutputStream os = new FileOutputStream("result.xml");
  InputStream is = getResponse.getEntity().getContent();
  byte[] buffer = new byte[4096];
  while ((size = is.read(buffer)) != -1) {
    os.write(buffer, 0, size);
  }
  os.flush();
  os.close();
  client.getConnectionManager().shutdown();
}

...

Obtaining Budget Available by Named Geographic Region

...

HTTPS Endpoint

The following endpoint is used with HTTP HTTPS GET:

...

Obtaining Budget Available by Latitude and Longitude

...

HTTPS Endpoint

The following endpoint is used with HTTP HTTPS GET:

...

Obtaining Budget Available by ID

...

HTTPS Endpoint

The following endpoint is used with HTTP HTTPS POST or GET:

...

...