The StockStatus API which allows each product to be updated with real-time requests, but these only relate to stock status and stock quantity. Authentication is handled with HTTP Basic - method. The API doesn't allow the update of other product information such as title or price - these must be controlled by the product feed.
The Stock Status API is in two parts:
The update requests are processed synchronously and subsequent requests for an stock inventory feed will return the updated values.
Replication from Fruugo's master product index to the slaves used by the live site is asynchronous and it may take a few minutes for the update to go live.
In principle the stockstatus API is there to maintain accurate stock levels between product inventory updates to ensure real-time accuracy. The Stockstatus API should only be called and a post request submitted for SKUs which have a change in stock value, and not all SKUs submitted if a change has not been made to their stock levels.
It should be used in one of two ways:
1) An individual SKU update is sent when the stock value of a SKU changes. Alternatively, you could batch these into a group of SKUs which have changed in a short time period, such as 10mins, to avoid multiple individual post requests. Please note: there is a 1000 expression limit per SKU batch update.
2) The stock inventory feed is polled and a comparison is run against the values, and then an update is submitted for the SKUs which have changed.