Jump to

• Request
• Response
• Examples

Get available active sources

get

/mftapp/rest/v1/sources

Gets the list of sources active in MFT based on the criteria like application type, binding type, etc. The response contains the list of sources with URLs.

Request

Query Parameters

• application(optional): string
  Type of the application binding you want to discover
• bindingType(optional): string
  Binding type of source you want to discover
• onlyEventEnabled(optional): boolean
  Discover only event enabled sources
• searchFilter(optional): string
  Full/partial name of source(s) to be discovered

Back to Top

Response

Supported Media Types

• application/json

200 Response

Describes active sources.

Body ()

Root Schema : activeSources

Type: object

Title: activeSources

Show Source

• sources(optional): array sources
  Title: sources

  Sources discovered

{
    "title":"activeSources",
    "type":"object",
    "properties":{
        "sources":{
            "title":"sources",
            "type":"array",
            "description":"Sources discovered",
            "items":{
                "title":"items",
                "type":"object",
                "properties":{
                    "name":{
                        "type":"string",
                        "description":"Name of the source."
                    },
                    "url":{
                        "type":"string",
                        "description":"URL of the source."
                    },
                    "bindingType":{
                        "type":"string",
                        "description":"Binding type of the source."
                    },
                    "eventInvokeUrl":{
                        "type":"string",
                        "description":"URL at which to invoke the event."
                    }
                }
            }
        }
    }
}

Nested Schema : sources

Type: array

Title: sources

Sources discovered

Show Source

• Array of: object items
  Title: items

{
    "title":"sources",
    "type":"array",
    "description":"Sources discovered",
    "items":{
        "title":"items",
        "type":"object",
        "properties":{
            "name":{
                "type":"string",
                "description":"Name of the source."
            },
            "url":{
                "type":"string",
                "description":"URL of the source."
            },
            "bindingType":{
                "type":"string",
                "description":"Binding type of the source."
            },
            "eventInvokeUrl":{
                "type":"string",
                "description":"URL at which to invoke the event."
            }
        }
    }
}

Nested Schema : items

Type: object

Title: items

Show Source

• bindingType(optional): string
  Binding type of the source.
• eventInvokeUrl(optional): string
  URL at which to invoke the event.
• name(optional): string
  Name of the source.
• url(optional): string
  URL of the source.

{
    "title":"items",
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of the source."
        },
        "url":{
            "type":"string",
            "description":"URL of the source."
        },
        "bindingType":{
            "type":"string",
            "description":"Binding type of the source."
        },
        "eventInvokeUrl":{
            "type":"string",
            "description":"URL at which to invoke the event."
        }
    }
}

500 Response

Error information.

Body ()

Root Schema : errors

Type: object

Title: errors

Show Source

• errorCode(optional): string
  The error code that Oracle Managed File Transfer returns.
• errorKey(optional): string
  The error key that Oracle Managed File Transfer returns.
• errorMessage(optional): string
  A message describing the error that Oracle Managed File Transfer returns.

{
    "title":"errors",
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"The error code that Oracle Managed File Transfer returns."
        },
        "errorKey":{
            "type":"string",
            "description":"The error key that Oracle Managed File Transfer returns."
        },
        "errorMessage":{
            "type":"string",
            "description":"A message describing the error that Oracle Managed File Transfer returns."
        }
    }
}

Back to Top

Examples

Example of Response Body: 200 Response

The following cURL command shows how to get the source details based on the various query parameters by submitting GET request on the REST resource:

curl -I -X GET -u <username>:<password>  -H "Content-Type: application/json"
  'http://<host>:<port>/mftapp/rest/v1/mftapp/rest/v1/sources?bindingType=file' 

The following example shows the contents of the response body for a successful request in JSON format:

{
	"sources": [
	  {
		"name": "src1",
		"url": "/scratch/demo",
		"bindingType": "File",
		"eventInvokeUrl": "/mftapp/rest/v1/events"
	  },
	  {
		"name": "src2",
		"url": "/scratch/username",
		"bindingType": "File",
		"eventInvokeUrl": "/mftapp/rest/v1/events"
	  }
	]
}

Example - Example of Response Body: 500 Response

The following example shows the contents of the response body for an successful request in JSON format:

{
  "errorCode":"MFT-5403"
  "errorKey":"MFT_WS_DISCOVERY_COULD_NOT_QUERY_MFT_SOURCES"
  "errorMessage":"Discovery service is unable to query MFT Sources for the given application {application} and search Filter {search filter}."
}

Back to Top