Web Services feature wishlist

From Wiki.zanox.com

Jump to: navigation, search

Contents

[edit] Products Resource

  • Minimum a search in all items of a shop AND a number of x shops is an absolulty must to build some useful aplications. Without that I always search all shops and there is no thematical focus possible.
  • And: search only one shop or a list of shops!
  • Why are the empty productItems delivered? Beta-Bug -> will be fixed
  • deliver relevant result sets: the search results deliver in 95% of the cases unsespected items. EG: if i search for "Converse CT Red OX" which is relatively specific i do not receive the specified item. If i search for "Converse CT Sailor Jerry Hi" (again rel. spec.) i receive the shoe "Converse CT Red OX" on first place, and the shoe i was actually looking for on the 7th place. (I could name 100s of other cases if wanted.....)
  • disable Products without an Image (maybe with a param) i.e. broken images, images stating that there is no image etc.
  • group result items by Productname (or the like) example: when searching for "Goofy" results 5-8 are the identical shirt
  • Additionally almost all searches deliver books from libri.de as first results. Does libri.de has got a special deal with zanox? Me (and i think users which will use the search inside the tools the contest developers are working on right now) don't want books, we want relevant products!.
  • Fixed standard image sizes
  • additional query filter: image size
  • Searching for EAN

[edit] Programs Resource

  • Some queries end up with a redirect. E.g. /programs redirects to /programs/. The documentation should give the "right" one from the start (or rather there should be no redirect)
  • But even though /programs redirects to /programs/, /programs/?items=x (with the /) doesn't work but /programs?items=x does!
  • The upper limit on items in /programs seems to be 50. No way!
  • I haven't checked what /programs returns, but we need a list of *all* programs (including those that are paused, stopped, rejected, etc.). This is needed to accurately detect programs that have "disappeared" from the active programs list. Note that we do not necessarily need the full details in this case, just a list of program IDs is enough.
  • How do I get program details with commissions that are actually valid for a given adspace? For instance the exact click/sale/lead amount(s), not min/max possible for the program.
  • What about the program status? e.g. paused/active
  • What about the application status? e.g. application open, active, etc?
  • New method to retrieve commission with the detail for CIDs
  • Obtain program description based on program sales region
  • retrieve programs by sales region

[edit] Admedia Resource

  • it should be possible to get the standard text link to the homepage of a program (maybe using a special linkType, like in /admedia/program/xxx/linkType=999). This would be ideal for portals or cash back systems that want to present the on-line shop (e.g. in some kind of shop catalog). It's currently not possible to determine the default link to the homepage automatically. So guess work is necessary.
  • Please loosen the query-constraints for admedia: the API should accept any ONE of the params format, ip, type etc at any (admedia) resource. Additionally it is important that only one parameter may be sufficient to be supplied to retrieve a result output.
  • new method getAdmediaFormats() to retrieve all valid zanox admedia formats
  • new method for get Admedia: filtered by program category and format ordered by adrank desc. As each programme is related to one or more categories ([1]) this would be a simple way to get admedia without preselecting a single program.
  • additional query filter: image size
  • rename short name for admedia type 805 from JAVA to SCRIPT (JAVA is misleading because it is typically Flash or JavaScript)
  • return text content of admedia with type 801 (TEXT) and 803 (TEXT_PICTURE)
  • add view tracking link to the result set

[edit] Reports Resource

  • the reference sales/leads timestamp have to be GMT and not CEST/CET.
  • a Click-Report would be most useful. Should at least contain Referrer-URL, clicktime, Adspace, Admedium and Programm. And of course it should be real-time.

[edit] Unsorted Requests

  • We would like to include some campaign driven content as well, but automatically. Which means we want to retrieve the content (link) of an AdServer via the API, preferable WITH the content of programs automatically included (if they fit in the AdServer dimensions). Any chances to get that?
  • The documentation needs to be fixed to indicate the actual format of the query URLs (host, /xml or /json prefix...)
  • The documentation needs to be a lot more explicit on the authentication, with actual examples that really work
  • Where is the call that allows us to get the product feed URL?
  • Some admedia still have width=0 and height=0 when it's obviously not the case (e.g. id 103690).
  • Where did the /ppv/ links go? How do we track impressions (and most importantly, post-impression revenue)?
  • A "last changed" date for admedia would be most useful
  • Some way to get the "clickthrough URL" (i.e. the URL the /ppc/ link redirects to) would be most useful as well
  • Admedia language would be most useful for programs that span multiple countries with different languages, or countries with several languages (Belgium, Switzerland, Hong Kong, Singapore...)
  • Gzip compression for REST and SOAP would be useful
  • Include the URI query parameter into the signature building for REST authentication


See also: Web Services, Web Services bug reports

Personal tools