Seedlist 1.0 REST service API

Seedlist 1.0 REST service API

The IBM Web Content Manager API for retrieving application content through a seedlist is based on the REST architecture style. To obtain seedlist content, third party crawlers or administrator applications need to construct and send only HTTP requests to the application servlet. All REST API requests are synchronous calls. The order of the parameters in the requests does not matter. The parameter names are case-sensitive and must be entered in the format described here.
An HTTP error response (for example, status code 404) is generated in the following situations:

An unknown or unsupported parameter is submitted as part of the request.
Web Content Manager cannot resolve the site area path or ID.
Web Content Manager cannot find any items.
The search seedlist enterprise application (Seedlist_Servlet) is not running.

The request is a standard HTTP GET command. The URL is formed by combining the seedlist servlet host name, port number, and path, followed by a collection of input parameters separated by ampersand (&) characters. The input parameters are entered as name-value pairs. For example:
http://host:port/wps/seedlist/myserver?SeedlistId=library_list&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=action&Range=number_of_entries

...where...

library_list One or more web content libraries, separated by commas. If no value is specified, all libraries are used.
action Action to perform on the request:

GetDocuments Retrieves a list of content items with their associated information.
number_of_entries Number of entries in the list of content items for each seedlist page returned. If no value specified, 100 items are returned.

SeedlistId

No value
Library (for example, library1)
Site area (for example, site_area1)
List of libraries, separated by commas (for example, library1,library2,library3)
JCRID of a site area

Retrieve a maximum of 100 items from a stand-alone server using the path to the site area

http://host:port/wps/seedlist/myserver?SeedlistId=library/site_area&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments

Example seedlists

Retrieve a maximum of 200 items from a stand-alone server using the ID of the site area

http://host:port/wps/seedlist/myserver?SeedlistId=site_area_id&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments&Range=200

Retrieve a maximum of 100 items from a specific library

http://host:port/wps/seedlist/myserver?SeedlistId=library&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments

Retrieve a maximum of 100 items from all libraries

To use all libraries, leave SeedlistId value empty.
http://host:port/wps/seedlist/myserver?SeedlistId=&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments

Retrieve a maximum of 100 items from a specified list of libraries

http://host:port/wps/seedlist/myserver?SeedlistId=library1,library2&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments

Retrieve a maximum of 100 items from a cluster

When referencing a cluster, specify the request with the host name and port number of the HTTP server.
http://http_server:port/wps/seedlist/myserver?SeedlistId=library/site_area&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments

Retrieve a maximum of 100 items from a virtual portal configured to use the URL context as the access point

http://http_server:port/wps/seedlist/myserver/virtual_portal_context?SeedlistId=library/site_area&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments

Retrieve a maximum of 100 items from a virtual portal configured to use a different host name as the access point

http://virtual_portal_host:port/wps/seedlist/myserver?SeedlistId=library/site_area&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments

Seedlist Parameters

Parameter Default Value Description
SeedlistID No default. Must be specified. Identifies the seedlist. This parameter can be specified in the following ways:

Empty value causes all libraries to be used.
Specific library (for example, library1)
Specific site area (for example, site_area1)
List of libraries, separated by commas: lib1,lib2,lib3
The JCRID of a site area

Start 0 Start number for currently returned section.
Range 100 Number of returned entries for current section.
Date No default. If not specified, all applicable results are returned. Indicates that entries (documents) that were updated after this date are retrieved. The date format (compliant to standard ISO 8601) is the following : dateTtimezone, where date is yyyy-MM-dd, time is HH:mm:ss, and zone is ±hhmm. This format includes time zone information, which is critical if the client and server are in different time zones.
Proper HTML URL encoding must be performed (for example, represent the plus symbol + as %2B).
Action GetDocuments Defines requested action to execute.

GetDocuments retrieve all underlying documents.

GetNumberOfDocuments returns the number of all underlying documents, typically for debug purposes. This value must be the same as the number of all documents returned from an appropriate GetDocuments request.

Format ATOM Defines the output format : ATOM / HTML/ XML.
Timestamp No default. Indicates the content provider timestamp from a previous crawling session. The timestamp represents for the content provider some snapshot of the content and allows the crawler to get only the content changes on the next crawling. This parameter is used for incremental crawling.

We can access the REST API for the WCM search seedlist 1.0 with a secured connection (HTTPS) or with an unsecured connection (HTTP). If we access this REST API with an unsecured connection, we are automatically redirected to a secured connection.
See also: Search issues

Parent Use the search seedlist 1.0 format

Parameter	Default Value	Description
SeedlistID	No default. Must be specified.	Identifies the seedlist. This parameter can be specified in the following ways: Empty value causes all libraries to be used. Specific library (for example, library1) Specific site area (for example, site_area1) List of libraries, separated by commas: lib1,lib2,lib3 The JCRID of a site area
Start	0	Start number for currently returned section.
Range	100	Number of returned entries for current section.
Date	No default. If not specified, all applicable results are returned.	Indicates that entries (documents) that were updated after this date are retrieved. The date format (compliant to standard ISO 8601) is the following : dateTtimezone, where date is yyyy-MM-dd, time is HH:mm:ss, and zone is ±hhmm. This format includes time zone information, which is critical if the client and server are in different time zones. Proper HTML URL encoding must be performed (for example, represent the plus symbol + as %2B).
Action	GetDocuments	Defines requested action to execute. GetDocuments retrieve all underlying documents. GetNumberOfDocuments returns the number of all underlying documents, typically for debug purposes. This value must be the same as the number of all documents returned from an appropriate GetDocuments request.
Format	ATOM	Defines the output format : ATOM / HTML/ XML.
Timestamp	No default.	Indicates the content provider timestamp from a previous crawling session. The timestamp represents for the content provider some snapshot of the content and allows the crawler to get only the content changes on the next crawling. This parameter is used for incremental crawling.