Introduction to the Assets Server SOAP API

Note: The Assets Server SOAP Web service has been deprecated. It remains available and fully supported for on-premise or privately hosted installations so that existing third-party applications or integrations can stay compatible with newer Assets Server versions. Because the SOAP Web service is not available for the cloud version of WoodWing Assets, we advise to use the REST API for any new developments.

The main purpose of the Assets Server SOAP webservice is to make it possible for third-party applications or customizations to talk to the backend of the Assets Server.

Some examples of operations that can be performed through the webservice:

• Search
• Search the system for assets matching a specific query.
• Basic information, metadata and URLs for thumbnails, previews and original are returned
• Retrieve
• Retrieve asset metadata and optionally the original file as attachment
• Originals, previews and thumbnails can already be returned over HTTP through the webapp, the URLs are included in the hits returned by a search
• Search relations
• Find relations for a given asset.
• The returned relations contain relation specific relation information (type, metadata) and information regarding the related asset (see search content).
• Import
• Import assets, including relations between these or existing assets
• Add/Update single pieces of content
• Create/Remove relations between assets in the system
• Remove
• Remove assets based on a query or;
• Remove a single folder including subfolders
• Move
• Move folders or sets of assets
• Copy
• Copy folders or sets of assets

The WSDL

The WSDL provides detailed technical information on how to communicate with the Assets Server webservice.

To access the WSDL webservice description file for the Assets Server service, open the following URL:

http://yourserver:port/webservice/elvis.wsdl

Detailed documentation is provided inside the WSDL.

Getting started

soapUIA great way to learn and experiment with the Assets Server SOAP API is to use the open-source tool soapUI. This tool analyses the Assets Server WSDL and generates sample requests that you can execute directly from the application and the resulting response. soapUI offers an easy way of playing with the Assets Server SOAP API and allows you to quickly gain insight in Assets Server SOAP requests, responses and how you can use that information in your own application.

SOAP envelope

The basic soap request contains an envelope with a header and body.

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
    soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Header>
 
        <wsse:Security>...</wsse:Security>
 
    </soapenv:Header>
    <soapenv:Body>
 
        ....
 
    </soapenv:Body>
</soapenv:Envelope>

Authentication header

When sending a SOAP request to the Assets Server webservice you need to specify a valid username and password to authenticate the request.

<soapenv:Header>
    <wsse:Security soapenv:mustUnderstand="1"
        xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
        <wsse:UsernameToken>
            <wsse:Username>...</wsse:Username>
            <wsse:Password>...</wsse:Password>
        </wsse:UsernameToken>
    </wsse:Security>
</soapenv:Header>