OptiAPI （预览版）

OptiAPI 的官方 API，它将无数日常作与 Power Automate 连接起来。

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD）
Power Apps	高级	除以下各项外的所有 Power Apps 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
Power Automate	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）

联系人
Name	奥利弗·布斯克·詹森
Email	support@optiapi.com

连接器元数据
发布者	Busk
网站	https://optiapi.com
隐私策略	https://optiapi.com/terms

正在创建连接

连接器支持以下身份验证类型：


默认	用于创建连接的参数。	所有区域	不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
API 密钥	securestring	此 API 的 API 密钥	True

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

从数组中删除项	按键值从数组中删除项。
从时间或日期添加或减去	通过添加或删除值来作日期时间。
合并多个 PDF 文件	将多个 PDF 文件合并为一个。
合并数组	将一个数组的键与另一个数组的值组合在一起。
在 PDF 文件上设置密码	在 PDF 文件上动态设置自定义密码。
在数组中查找重复项	此作从数组中检索并返回重复值。
基于正则表达式替换字符串中的文本	根据正则表达式将一个或多个单词替换为另一个单词。
对扫描的 PDF 或图像文件执行 OCR	将字符串替换为另一个单词。
对数组进行区块	将数组分解成区块。
对数组进行排序	从高到低或从降序到升序对数组进行排序。
将 PDF 文件转换为文本	将 PDF 文件转换为文本。
将字符串转换为 datetime 对象	将字符串转换为有效的日期/时间格式。
平展数组	此作将多维数组平展为单个维度数组。
按数组键分组	此作按给定键对数组的项进行分组。
替换字符串中的文本	将一个或多个单词替换为另一个单词。
查找数组之间的差异	此作将数组与另一个数组进行比较。
根据正则表达式查找字符串中的值	在字符串中查找一个或多个值。
检查数组是否包含值	确定数组是否包含给定项。
第一个数组中的位置	此作返回具有给定键/值对的数组中的第一个元素。
筛选数组以获取 false 值	此作从数组中删除 false 条目。
获取 PDF 元数据信息	从 PDF 文件获取元数据。
获取数组中的唯一项	该作返回数组中的所有唯一项。
计算平均值	计算给定键的平均值。

从数组中删除项

操作 ID:: RemoveItemFromArray

按键值从数组中删除项。

参数

名称	密钥	必需	类型	说明
数组	array	True	array of string	数组
Key	key	True	string	将删除与此键匹配的项目。

名称	路径	类型	说明
数组	array	array of string	数组

从时间或日期添加或减去

操作 ID:: AddOrSubtractFromTimeOrDates

通过添加或删除值来作日期时间。

参数

名称	密钥	必需	类型	说明
Action	action	True	string	要添加或减去的作。例如，可以是“year”、“weekday”、“week”或“day”。
输入日期/时间	datetime	True	string	要添加到或减去的输入值。
Operator	operator	True	string	是否应从输入日期时间添加或减去值。可以是“add”或“减法”。
输出格式	outputFormat		string	字符串应转换为的日期时间格式（例如 d-m-Y）
价值	value	True	integer	要加减的值。

名称	路径	类型	说明
日期时间	datetime	string	新转换的日期时间

合并多个 PDF 文件

操作 ID:: CombineMultiplePdfFiles

将多个 PDF 文件合并为一个。

参数

名称	密钥	必需	类型	说明
pdfs	pdfs	True	array of string	pdfs

名称	路径	类型	说明
文件内容	content	string	组合 PDF 文件的 base64 编码字符串。

合并数组

操作 ID:: CombineArray

将一个数组的键与另一个数组的值组合在一起。

参数

名称	密钥	必需	类型	说明
请求的内容类型。	Content-Type	True	string	Content-Type
请求的接受类型。	Accept	True	string	接受
钥匙	keys	True	array of string	钥匙
values	values	True	array of string	values

名称	路径	类型	说明
数组	array	array of string	数组

在 PDF 文件上设置密码

操作 ID:: SetPasswordOnAPdfFile

在 PDF 文件上动态设置自定义密码。

参数

名称	密钥	必需	类型	说明
请求的内容类型。	Content-Type	True	string	Content-Type
请求的接受类型。	Accept	True	string	接受
密码	password	True	string	要应用于 PDF 文件的密码。
PDF 文件	pdf	True	byte	PDF 文件的 base64 内容。

名称	路径	类型	说明
文件内容	content	string	带密码的 PDF 文件的 base64 编码字符串。

在数组中查找重复项

操作 ID:: FindDuplicatesInArrays

此作从数组中检索并返回重复值。

参数

名称	密钥	必需	类型	说明
数组	array	True	array of string	数组
Key	key		string	可以指定键以在特定属性下查找重复项（可选）

名称	路径	类型	说明
数组	array	array of string	数组

基于正则表达式替换字符串中的文本

操作 ID:: ReplaceTextInStringBasedOnARegularExpression

根据正则表达式将一个或多个单词替换为另一个单词。

参数

名称	密钥	必需	类型	说明
正则表达式模式	pattern	True	string	在搜索中使用的正则表达式模式。
替换值	replacement	True	string	要替换为找到值的字符串。
输入文本	text	True	string	要对其执行文本替换的字符串。

名称	路径	类型	说明
文本	text	string	替换的文本字符串

对扫描的 PDF 或图像文件执行 OCR

操作 ID:: PerformOcrOnAScannedPdfOrImageFile

将字符串替换为另一个单词。

参数

名称	密钥	必需	类型	说明
文件内容	file	True	string	文件的 base64 编码字符串（PDF 或图像）。
语言	language		string	输入文件的语言。（default = eng）
OCR 引擎（OEM）	oem	True	integer	要使用的 OCR 引擎。（0 = 旧版，1 = LSTM）
页面分段方法（PSM）	psm	True	integer	OCR 如何分段输入图像？
剪裁输出	trim	True	boolean	如果启用，这将删除输出文本的所有多余的间距和换行符。
文件类型	type	True	string	输入文件类型。

名称	路径	类型	说明
输出文本	text	string	OCR作的输出文本。

对数组进行区块

操作 ID:: ChunkAnArray

将数组分解成区块。

参数

名称	密钥	必需	类型	说明
数组	array	True	array of string	数组
区块大小	size	True	integer	每个区块的大小。

名称	路径	类型	说明
数组	array	array of string	数组

对数组进行排序

操作 ID:: SortAnArray

从高到低或从降序到升序对数组进行排序。

参数

名称	密钥	必需	类型	说明
数组	array	True	array of string	数组
排序	sort	True	string	数组项应如何排序？

Body: StandardArrayResponse

将 PDF 文件转换为文本

操作 ID:: ConvertAPdfFileToText

将 PDF 文件转换为文本。

参数

名称	密钥	必需	类型	说明
结束页	endPage		integer	如果设置，这是作将转换为文本的最后一页。
输出布局	layout	True	string	输出内容的布局。可以从“raw”或“original”中进行选择。原始版将保留布局。
文件内容	pdf	True	byte	PDF 文件的 base64 编码字符串。
起始页	startPage		integer	如果已设置，则这是作将转换为文本的第一页。

Body: StandardArrayResponse

将字符串转换为 datetime 对象

操作 ID:: ConvertAStringToADatetimeObject

将字符串转换为有效的日期/时间格式。

参数

名称	密钥	必需	类型	说明
请求的内容类型。	Content-Type	True	string	Content-Type
请求的接受类型。	Accept	True	string	接受
输入格式	inputFormat	True	string	输入字符串的格式。
输出格式	outputFormat	True	string	字符串应转换为的日期时间格式。
输入字符串	string	True	string	要转换为日期时间的输入字符串。
Timezone	timezone		string	日期时间应转换为的时区（可选）

名称	路径	类型	说明
日期时间	datetime	string	新转换的日期时间

平展数组

操作 ID:: FlattenAnArray

此作将多维数组平展为单个维度数组。

参数

名称	密钥	必需	类型	说明
数组	array	True	array of string	数组
深度	depth		integer	应平展的深度级别（整数）

名称	路径	类型	说明
数组	array	array of string	数组

按数组键分组

操作 ID:: GroupByAnArrayKey

此作按给定键对数组的项进行分组。

参数

名称	密钥	必需	类型	说明
数组	array	True	array of string	数组
Key	key	True	string	分组依据的键。

名称	路径	类型	说明
数组	array	array of string	数组

替换字符串中的文本

操作 ID:: ReplaceTextInString

将一个或多个单词替换为另一个单词。

参数

名称	密钥	必需	类型	说明
请求的内容类型。	Content-Type	True	string	Content-Type
请求的接受类型。	Accept	True	string	接受
替换为	replace	True	string	要替换为找到的字符串的字符串或单词。
寻找	search	True	string	在输入字符串中找到的字符串或单词。
输入文本	text	True	string	要执行替换作的输入文本。

名称	路径	类型	说明
文本消息	text	string	文本消息

查找数组之间的差异

操作 ID:: FindDifferenceBetweenArrays

此作将数组与另一个数组进行比较。

参数

名称	密钥	必需	类型	说明
数组	array	True	array of string	数组
比较	compare	True	array of string	比较

名称	路径	类型	说明
数组	array	array of string	数组

根据正则表达式查找字符串中的值

操作 ID:: FindValuesFromAStringBasedOnARegularExpression

在字符串中查找一个或多个值。

参数

名称	密钥	必需	类型	说明
组	group		integer	要返回的组。（默认值 = 0）
正则表达式模式	pattern	True	string	正则表达式模式。
输入文本	text	True	string	要在其中查找引用的字符串。

名称	路径	类型	说明
values	values	array of string	values

检查数组是否包含值

操作 ID:: CheckIfArrayContainAValue

确定数组是否包含给定项。

参数

名称	密钥	必需	类型	说明
数组	array	True	array of string	数组
Key	key	True	string	要在其中搜索特定值的键。
搜索词	search	True	string	要查找的搜索词。

名称	路径	类型	说明
包含	contains	boolean	数组是否包含给定项（bool）

第一个数组中的位置

操作 ID:: FirstWhereWithinAnArray

此作返回具有给定键/值对的数组中的第一个元素。

参数

名称	密钥	必需	类型	说明
数组	array	True	array of string	数组
Key	key	True	string	要搜索的键。
Operator	operator		string	执行运算符子句（可选）
寻找	value	True	string	要搜索的值。

名称	路径	类型	说明
数组	array	array of string	数组

筛选数组以获取 false 值

操作 ID:: FilterAnArray

此作从数组中删除 false 条目。

参数

名称	密钥	必需	类型	说明
数组	array	True	array of string	数组
保留数组键	preserveKeys	True	boolean	如果设置为 true，则返回的数组将保留原始属性的键。

名称	路径	类型	说明
数组	array	array of string	数组

获取 PDF 元数据信息

操作 ID:: GetPdfMetadataInformation

从 PDF 文件获取元数据。

参数

名称	密钥	必需	类型	说明
文件内容	pdf	True	byte	PDF 文件的 base64 编码字符串。

名称	路径	类型	说明
PDF 版本	metadata.PDFVersion	string	PDFVersion
作者	metadata.author	string	PDF 文件的作者
创建日期	metadata.creationDate	string	最初创建 PDF 文件的日期。
Creator	metadata.creator	string	PDF 文件的创建者。
已加密	metadata.encrypted	string	PDF 文件是否加密。返回“yes”/“no”。
文件大小	metadata.fileSize	string	PDF 文件的文件大小（以字节为单位）。
表格	metadata.form	string	如果在 PDF 文件中找到任何表单。
修改日期	metadata.modDate	string	如果文件已更改。（default = null）
已优化	metadata.optimized	string	如果文件已优化。（default = “no”）
输出	metadata.output	array of string	输出
页面旋转	metadata.pageRot	string	PDF 文件的旋转。
页面大小	metadata.pageSize	string	PDF 文件的页面大小。
页数	metadata.pages	string	PDF 文件中的页数。
由	metadata.producer	string	PDF 文件的生成者。
标记	metadata.tagged	string	是否标记 PDF 文件。返回“yes”/“no”。
Title	metadata.title	string	PDF 文件的标题。

获取数组中的唯一项

操作 ID:: GetUniqueItemsInAnArray

该作返回数组中的所有唯一项。

参数

名称	密钥	必需	类型	说明
数组	array	True	array of string	数组
Key	key		string	确定唯一性的特定键。

名称	路径	类型	说明
数组	array	array of string	数组

计算平均值

操作 ID:: CalculateAverage

计算给定键的平均值。

参数

名称	密钥	必需	类型	说明
数组	array	True	array of string	数组
Key	key	True	string	要计算平均值的键。

名称	路径	类型	说明
平均值	average	integer	给定键的计算平均值。

定义

StandardArrayResponse

名称	路径	类型	说明
结果数组	array	array of string	包含新项的数组。