APIMethods/experimental/wwws.searchPublic/private

TracNav

wwws.searchPublic

Search for public www's.

params

  • searchterms --- Text query. Use the keywords 'OR' or 'OF' (all uppercase) to search for multiple alternatives. Enclose multiple words in double quotes to search for an exact phrase. If not specified or empty, all public wwws will be returned.
    • Optional
  • scope_minid --- Only www's posted after this one will be received.
    • Optional
  • scope_maxid --- Only www's posted before this one will be received.
    • Optional
  • limit --- The maximum number of results desired.
    • Optional

responsefields

This method supports the use of <a href='http://hyves-developers.nl/documentation/data-api/global-ha-parameters'>ha_responsefields</a>. Acceptable values are a comma separated list of 0 or more of the following:

sort

Sorted by age. The most recently created items are returned first.

extra

  • To get the list of new www's posted after a first query, poll the server passing as scope_minid the value of scope_maxid returned in the previous call (found in the info block). It is advised not to poll the server more often than once every 20 seconds. If you want to show updates more often than that, cache the results in a client-side queue and show them to the user in more frequent batches.
  • To get the list of www's posted before the ones retrieved by a previous query, call this method passing as scope_maxid the values of scope_min returned in the previous call (found in the info block).
  • If the value of scope_minid in a response is 0, then no messages older than the ones already retrieved are present on the server.
  • Note that retrieving something by id always succeeds (as long as the id is valid), even if the visibility settings of the object do not allow viewing it. If some user is not allowed to view something, he/she will not get the id from another call.
  • This function may return more information if you supply a valid access token to oauth_token.
  • For more information on oAuth, see <a href='http://www.hyves-developers.nl/documentation/data-api/hyves-api-oauth/'>http://www.hyves-developers.nl/documentation/data-api/hyves-api-oauth/</a>.

No request and result generated for this method.

returnvalues