Version 1.0
Connector Overview: This page documents all 7 actions for the Woodwingstudioconnector v1.0.
Administration
POST Call Administration Method
/{Studio_Server_Directory}/adminindex.php
This endpoint makes an HTTP POST request to {{Studio_Server_URL}}/{{Studio_Server_Directory}}/adminindex.php?protocol=JSON to perform a "LogOn" method. The request body should include the "AdminUser" and "Password" parameters for authentication, along with other optional parameters. The response will contain the result of the LogOn method execution.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
The directory path on the Studio Server where the administration endpoint is located. |
|
|
The protocol to use for the administration request (e.g., 'http' or 'https'). |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
The administration method to invoke. |
|
|
An identifier associated with the administration method call. |
|
|
The JSON-RPC version to use for the request (e.g., '2.0'). |
General
POST Create Object
/{Studio_Server_Directory}/{entryPoint}
Create Object
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
The directory path on the Studio Server where the object creation endpoint is located. |
|
|
The entry point within the Studio Server for creating the object. |
|
|
The protocol to use for the request (e.g., 'http' or 'https'). |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
An identifier for the object creation request. |
|
|
The JSON-RPC version to use for the request (e.g., '2.0'). |
|
|
The method to invoke for creating the object. |
Digital Object (2)
DELETE Delete Transfer Server Request
/{Studio_Server_Directory}/transferindex.php
This endpoint is used to delete a specific file from the server directory. The request should include the file upload URL, current ticket, and the UUID for the PUT method in the query parameters. The response will indicate the success or failure of the deletion operation.
Request Body
This request does not require a request body.
Response Body
-
success (boolean): Indicates whether the deletion operation was successful.
-
message (string): Provides a message regarding the deletion operation.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
The directory path on the Studio Server where the transfer index endpoint is located. |
|
|
The ticket identifier for the transfer request to delete. |
|
|
The file GUID associated with the transfer request. |
|
|
The HTTP method that was used for the original transfer request. |
|
|
The format of the response (e.g., 'json' or 'xml'). |
|
|
The response format expected from the API (e.g. application/json). |
PUT Upload Transfer Server Request
/{Studio_Server_Directory}/transferindex.php
This endpoint allows you to upload a file to the specified directory on the Studio Server. The HTTP PUT request should be made to the provided URL with the ticket and fileguid as query parameters.
The response of this request is documented as a JSON schema.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
The directory path on the Studio Server where the transfer index endpoint is located. |
|
|
The ticket identifier for the upload request. |
|
|
The file GUID to associate with the uploaded object. |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
The file to upload to the transfer server. |
Planning
POST Call Planning Method
/{Studio_Server_Directory}/editorialplan.php
This endpoint allows you to send an HTTP POST request to the specified URL and directory with the purpose of logging on. The request payload should be in JSON format and include the method, id, and Params with specific user information. Upon successful execution, the response will be documented as a JSON schema.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
The directory path on the Studio Server where the planning endpoint is located. |
|
|
The protocol to use for the planning request (e.g., 'http' or 'https'). |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
The planning method to invoke. |
|
|
An identifier associated with the planning method call. |
|
|
The JSON-RPC version to use for the request (e.g., '2.0'). |
Webhooks
POST Call Webhook Method
/{Studio_Server_Directory}/pluginindex.php
ConnectWebhooks Registration - GetTriggerOptions
This endpoint allows you to retrieve trigger options for ConnectWebhooks registration.
Request Body
-
Method: JSON
-
method: The method to be executed, set to "GetTriggerOptions".
-
id: The ID of the request, set to "1".
-
params: An array containing the request parameters, including the "Ticket" and "classname".
Response
The response will be in JSON format and follows the schema:
{
"id": "",
"result": {
"Options": [
{
"Entity": {
"Name": "",
"DisplayName": "",
"__classname__": ""
},
"EventTypes": [
{
"Name": "",
"DisplayName": "",
"__classname__": ""
}
],
"__classname__": ""
}
],
"__classname__": ""
},
"jsonrpc": ""
}
```
This JSON schema represents the structure of the response returned by the API endpoint.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
The directory path on the Studio Server where the webhook endpoint is located. |
|
|
The plugin identifier for the webhook. |
|
|
The interface name for the webhook. |
|
|
The protocol to use for the webhook request (e.g., 'http' or 'https'). |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
The webhook method to invoke. |
|
|
An identifier associated with the webhook method call. |
|
|
The JSON-RPC version to use for the request (e.g., '2.0'). |
Workflow
POST Call Workflow Method
/{Studio_Server_Directory}/index.php
This HTTP POST request is used to create objects by sending a payload to the specified endpoint. The request is made to the {{Studio_Server_URL}}/{{Studio_Server_Directory}}/index.php?protocol=JSON URL with a JSON payload in the raw request body.
Request Body
-
method (string): Specifies the method as "CreateObjects".
-
id (string): Represents the ID as "33".
-
params (array): Contains an array of parameters including "Ticket", "Lock", and "Objects".
-
Ticket (string): Represents the ticket value, which is a placeholder.
-
Lock (boolean): Indicates whether the object is locked or not.
-
Objects (array): Contains an array of objects with metadata and files.
-
MetaData (object): Contains various metadata properties such as BasicMetaData, WorkflowMetaData, RightsMetaData, SourceMetaData, ContentMetaData, and ExtraMetaData.
-
Files (array): Contains an array of files with properties like Rendition, Type, and FileUrl.
-
jsonrpc (string): Specifies the JSON-RPC version as "2.0".
Response
The response to this request will contain the result of the "CreateObjects" method call, along with any relevant data or error messages.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
The directory path on the Studio Server where the workflow endpoint is located. |
|
|
The protocol to use for the workflow request (e.g., 'http' or 'https'). |
|
|
The username for authentication with the workflow endpoint. |
|
|
The password for authentication with the workflow endpoint. |
|
|
The client name identifier for the workflow request. |
|
|
The client application name for the workflow request. |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
The workflow method to invoke. |
|
|
An identifier associated with the workflow method call. |
|
|
The JSON-RPC version to use for the request (e.g., '2.0'). |