visiblethread
Module visiblethread
API
Definitions
![](https://bcentral-packageicons.azureedge.net/images/ballerinax_visiblethread_1.1.0.png)
ballerinax/visiblethread Ballerina library
Overview
This is a generated connector from VisibleThread API v1.0 OpenAPI specification.
The VisibleThread API provides services for analyzing or searching documents and web pages.
Prerequisites
Before using this connector in your Ballerina application, complete the following:
- Create a Visible Thread account
- Obtain API key by contacting support@visiblethread.com
Clients![](/images/permalink.svg)
visiblethread: Client![](/images/permalink.svg)
This is a generated connector for VisibleThread API v1.0 OpenAPI specification. The VisibleThread API provides services for analyzing or searching documents and web pages.
Constructor![](/images/permalink.svg)
Gets invoked to initialize the connector
.
The connector initialization requires setting the API credentials.
Contact support@visiblethread.com to request an API key.
init (ApiKeysConfig apiKeyConfig, ClientConfiguration clientConfig, string serviceUrl)
- apiKeyConfig ApiKeysConfig - API keys for authorization
- clientConfig ClientConfiguration {} - The configurations to be used when initializing the
connector
- serviceUrl string "https://api.visiblethread.com/api/v1" - URL of the target service
getDocs![](/images/permalink.svg)
function getDocs() returns DocumentListSummary[]|error
Get your list of documents
Return Type
- DocumentListSummary[]|error - Successful response
getDocById![](/images/permalink.svg)
function getDocById(int docId) returns DocumentResponseDetailed|error
Get data from a previously submitted document
Parameters
- docId int - Id of document to fetch
Return Type
- DocumentResponseDetailed|error - document response contained readability details for the document
getDictionaries![](/images/permalink.svg)
Get your list of dictionaries
getSearchResults![](/images/permalink.svg)
Get your list of searches
runSearch![](/images/permalink.svg)
Run a search
Parameters
- payload Search - Run a search on document docId using dictionarydictId
getSearchResultsById![](/images/permalink.svg)
function getSearchResultsById(int docId, int dictionaryId, boolean matchingOnly) returns Response|error
Gets search results for a particular document/dictionary
Parameters
- docId int - Id of document
- dictionaryId int - Id of dictionary
- matchingOnly boolean - Only returning paragraphs containing a match
getScans![](/images/permalink.svg)
function getScans() returns ScanResponseSummary[]|error
Get your list of scans
Return Type
- ScanResponseSummary[]|error - Successful response
runScan![](/images/permalink.svg)
function runScan(NewScan payload) returns NewScanResponse|error
Run a new scan
Parameters
- payload NewScan - Scan title and webUrls to analyze
Return Type
- NewScanResponse|error - Successful response
getScanById![](/images/permalink.svg)
function getScanById(int scanId) returns ScanResponseDetailed|error
Get data from a previously run scan
Parameters
- scanId int - Id of scan to fetch
Return Type
- ScanResponseDetailed|error - scan response
getScanUrlById![](/images/permalink.svg)
function getScanUrlById(int scanId, int urlId) returns WebUrlDetail|error
Gets data for a particular scan/webUrl
Return Type
- WebUrlDetail|error - scan response
Records![](/images/permalink.svg)
visiblethread: AdverbsInner![](/images/permalink.svg)
Fields
- 'start int? -
- end int? -
- text string? -
visiblethread: Analysis![](/images/permalink.svg)
Fields
- title string? -
- stats Stats? -
visiblethread: ApiKeysConfig![](/images/permalink.svg)
Provides API key configurations needed when communicating with a remote HTTP endpoint.
Fields
- apiKey string - All requests on the VisibleThread API needs to include an API key. The API key can be provided as part of the query string or as a request header. The name of the API key needs to be
apiKey
visiblethread: DocumentListSummary![](/images/permalink.svg)
Fields
- id int? -
- name string? -
visiblethread: DocumentResponseDetailed![](/images/permalink.svg)
Fields
- id int? -
- started string? -
- eta string? -
- completed string? -
- title string? -
- stats Stats? -
- scanSettings NewdocumentresponseScansettings? -
- paragraphs DocumentresponsedetailedParagraphs[]? -
visiblethread: DocumentresponsedetailedParagraphs![](/images/permalink.svg)
Fields
- text string? -
- paragraphIndex int? -
- paragraphCounter int? -
- stats DocumentresponsedetailedStats? -
visiblethread: DocumentresponsedetailedStats![](/images/permalink.svg)
Fields
- longSentences LongSentences[]? -
- passives Passives[]? -
- veryLongSentences VeryLongSentences[]? -
- hiddenVerbs HiddenVerbs[]? -
- adverbs Adverbs[]? -
visiblethread: DocumentResponseNotReady![](/images/permalink.svg)
Fields
- id int? -
- started string? -
- eta string? -
visiblethread: HiddenverbsInner![](/images/permalink.svg)
Fields
- 'start int? -
- end int? -
- noun string? -
- text string? -
visiblethread: LongsentencesInner![](/images/permalink.svg)
Fields
- 'start int? -
- end int? -
- wordCount int? -
visiblethread: NewDocumentResponse![](/images/permalink.svg)
Fields
- docId int -
- task string -
- scanSettings NewdocumentresponseScansettings -
visiblethread: NewdocumentresponseScansettings![](/images/permalink.svg)
Fields
- longSentenceWordCount int? -
- veryLongSentenceWordCount int? -
visiblethread: NewScan![](/images/permalink.svg)
Fields
- title string -
- webUrls NewscanWeburls[] -
- scanSettings NewscanScansettings? -
visiblethread: NewScanResponse![](/images/permalink.svg)
Fields
- id int -
- title string -
- webUrls NewscanresponseWeburls[] -
visiblethread: NewscanresponseWeburls![](/images/permalink.svg)
Fields
- url string -
- id int -
visiblethread: NewscanScansettings![](/images/permalink.svg)
Fields
- longSentenceWordCount int? -
- veryLongSentenceWordCount int? -
visiblethread: NewscanWeburls![](/images/permalink.svg)
Fields
- url string -
visiblethread: PassivesInner![](/images/permalink.svg)
Fields
- 'start int? -
- end int? -
- verb string? -
- passivePiece string? -
visiblethread: ScanDetailed![](/images/permalink.svg)
Fields
- title string -
- webUrls WebUrl[] -
- stats Stats -
visiblethread: ScanResponseDetailed![](/images/permalink.svg)
Fields
- id int? -
- started string? -
- eta string? -
- completed string? -
- scan ScanDetailed? -
visiblethread: ScanResponseSummary![](/images/permalink.svg)
Fields
- id int? -
- started string? -
- eta string? -
- completed string? -
- scan ScanSummary? -
visiblethread: ScanSummary![](/images/permalink.svg)
Fields
- title string -
- webUrls WebUrlHeader[] -
visiblethread: Search![](/images/permalink.svg)
Fields
- docId int -
- dictId int -
visiblethread: Stats![](/images/permalink.svg)
Fields
- avgSentenceLength int? -
- fleschReadingLevel int? -
- wordCount int? -
- sentenceCount int? -
- longSentenceCount int? -
- fleschKincaidGradeLevel float? -
- passiveSentenceCount int? -
visiblethread: VerylongsentencesInner![](/images/permalink.svg)
Fields
- 'start int? -
- end int? -
- wordCount int? -
visiblethread: WebResponseNotReady![](/images/permalink.svg)
Fields
- id int? -
- started string? -
- eta string? -
visiblethread: WebUrl![](/images/permalink.svg)
Fields
- Fields Included from *WebUrlHeader
- analysis Analysis -
visiblethread: WebUrlDetail![](/images/permalink.svg)
Fields
- title string -
- url string -
- stats Stats -
- paragraphs DocumentresponsedetailedParagraphs[]? -
visiblethread: WebUrlHeader![](/images/permalink.svg)
Fields
- id int -
- url string -
Import
import ballerinax/visiblethread;
Metadata
Released date: over 2 years ago
Version: 1.1.0
License: Apache-2.0
Compatibility
Platform: any
Ballerina version: slbeta6
GraalVM compatible: Yes
Pull count
Total: 1
Current verison: 0
Weekly downloads
Keywords
Business Intelligence/Language Analysis
Cost/Paid
Contributors
Dependencies