WoodWing Help Center

Elvis 6 REST API - log usage stats

Elvis 6 REST API - log usage stats

POST

http://yourserver.com/services/logUsage
    ?assetId=<asset id>
    &action=<CUSTOM_ACTION_YOUR_ACTION>
    &<queryParam>=<value>

What does it do?

Logs an entry in the stats database for usage statistics about assets. A record will be added to the "usage_log" table.

Most information in the "usage_log" table is automatically filled based on the currently authenticated user and the specified assetId: log_date, user_name, user_groups, client_type, remote_addr, remote_host, action_type, asset_id, asset_path, asset_type, asset_domain, details.

POST requests only

This REST API only accepts POST requests, not GET requests. Also, the POST request needs to include a cross-site request forgery (csrf) token.

The csrf token is a unique code which, by including it in the request, also makes the POST request unique and therefore much more secure.

The csrf token is obtained by first logging in to Elvis Server through a POST request. The response that is received will include the csrf token which can then be used in subsequent POST requests as a http header:

"X-CSRF-TOKEN: <some_csrf_token>"

For more information including examples, see Elvis 6 REST API - Performing a POST request with a csrf token.

Parameters

assetId

The id of the asset for which the action is logged.

Required.

action

Name of the action that is logged. This must start with "CUSTOM_ACTION_", if it does not, this prefix will be added to the logged action name.

Required.

*

All other parameters are logged as details for the action.

Optional.

Return value

This call does not return a value, it only returns an http 200 status OK.

Examples

logUsage

http://demo.elvisdam.com/services/logUsage
    ?assetId=5LMAQTW9qfhANn7f6JJVpl
    &action=CUSTOM_ACTION_inserted_in_wordpress
    &insertSize=400x300
    &pageUrl=http://www.example.com/my-first-blog-post

Document history

  • 27 July 2017: Added section 'Post requests only'.
Was this article helpful?
0 out of 0 found this helpful / Created: / Updated:
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.