Sklik API

Banners

banners.check

Check banners attributes before create or update.

If the response status is 206, it means that banner does not contain errors and will be accepted, but we still have some suggestions for it. If the response status is 406, you shall fix your arguments according to diagnostics in order to successfully call banners.create or banners.update.

Method response might look like this: banners.check( "…", { }) => { "status": 406, "statusMessage": "Invalid data in request", "session": "…", "diagnostics": [ {"id": "clickthruUrl_is_too_long"}, {"field": "clickthruUrl"} ] }

Parameters

struct user {
string session Session (as retrieved from client.login())
int userId (optional) User ID
}
array banners (
struct {
int id (optional) Banner ID
string name (optional) Banner name
string clickthruUrl (optional) Target URL
string status (optional) Status:
  • active:
  • suspend:
binary file (optional) Image data (jpg, png, gif)
}
)

Response

struct {
int status Status code
string statusMessage Status code description
string session Refreshed session
array diagnostics ( (optional) Various diagnostics(warnings, errors, other information)
struct {
...
}
)
}

Response status codes:

List of all possible response status codes:

Diagnostics:

List of all possible diagnostics:

            
        

Copyright © 1996-2019

www.seznam.cz   Help   Contact