OptiAPI (anteprima)

L'API ufficiale per OptiAPI, che connette innumerevoli azioni quotidiane con Power Automate.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio	Class	Regions
Copilot Studio	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Normale	Tutte le aree di App per la logica , ad eccezione delle seguenti:      - Aree di Azure per enti pubblici      - Aree di Azure Cina      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Di alta qualità	Tutte le aree di Power Apps , ad eccezione dei seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	Oliver Busk Jensen
Email	support@optiapi.com

Metadati del connettore
Editore	Busk
Sito web	https://optiapi.com
Informativa sulla privacy	https://optiapi.com/terms

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Predefinita	Parametri per la creazione della connessione.	Tutte le aree geografiche	Non condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome	TIPO	Description	Obbligatorio
Chiave API	securestring	Chiave API per questa API	Vero

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	100	60 secondi

Azioni

Aggiungere o sottrarre da date o ora	Modificare datetime aggiungendo o sottraendo valori.
Appiattire una matrice	Questa azione rende flat una matrice multidimensionale in una singola matrice di dimensioni.
Blocco di una matrice	Suddividere una matrice in blocchi.
Calcolare la media	Calcola il valore medio di una determinata chiave.
Combinare più file PDF	Combinare più file PDF in uno.
Combinare una matrice	Combinare le chiavi di una matrice con i valori di un'altra matrice.
Controllare se la matrice contiene un valore	Determina se la matrice contiene un determinato elemento.
Convertire un file PDF in testo	Converte un file PDF in testo.
Convertire una stringa in un oggetto datetime	Trasformare una stringa in un formato datetime valido.
Eseguire OCR in un file PDF o immagine digitalizzato	Sostituisce una stringa con un'altra parola.
Filtrare una matrice per i valori false	Questa azione rimuove le voci false da una matrice.
Impostare la password in un file PDF	Imposta dinamicamente una password personalizzata in un file PDF.
Ordinare una matrice	Ordinare una matrice da alta a bassa o da decrescente a crescente.
Ottenere elementi univoci in una matrice	L'azione restituisce tutti gli elementi univoci in una matrice.
Ottenere informazioni sui metadati PDF	Ottenere i metadati da un file PDF.
Prima posizione all'interno di una matrice	Questa azione restituisce il primo elemento in una matrice con la coppia chiave/valore specificata.
Raggruppa per chiave di matrice	Questa azione raggruppa gli elementi di una matrice in base a una determinata chiave.
Rimuovere l'elemento dalla matrice	Rimuove un elemento da una matrice in base al valore della chiave.
Sostituire il testo nella stringa	Sostituire una o più parole con un'altra parola.
Sostituire il testo nella stringa in base a un'espressione regolare	Sostituire una o più parole con un'altra parola, in base a un'espressione regolare.
Trovare duplicati nelle matrici	Questa azione recupera e restituisce valori duplicati da una matrice.
Trovare la differenza tra matrici	Questa azione confronta una matrice con un'altra matrice.
Trovare valori da una stringa basata su un'espressione regolare	Trovare uno o più valori in una stringa.

Aggiungere o sottrarre da date o ora

ID operazione:

AddOrSubtractFromTimeOrDates

Modificare datetime aggiungendo o sottraendo valori.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Action	action	True	string	Azione da aggiungere o sottrarre anche. Ad esempio, può essere 'year', 'weekday', 'week' o 'day'.
Data/ora di input	datetime	True	string	Valore di input da cui aggiungere o sottrarre.
Operator	operator	True	string	Indica se è necessario aggiungere o sottrarre il valore dall'ora della data di input. Può essere "add" o "sottrazione".
Formato output	outputFormat		string	Formato di data e ora in cui deve essere convertita la stringa (ad esempio d-m-Y)
Value	value	True	integer	Valore da aggiungere o sottrarre.

Restituisce

Nome	Percorso	Tipo	Descrizione
Data/Ora	datetime	string	Nuova data trasformata

Appiattire una matrice

ID operazione:

FlattenAnArray

Questa azione rende flat una matrice multidimensionale in una singola matrice di dimensioni.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
elenco	array	True	array of string	elenco
Profondità	depth		integer	Livello di profondità che deve essere appiattito (intero)

Restituisce

Nome	Percorso	Tipo	Descrizione
elenco	array	array of string	elenco

Blocco di una matrice

ID operazione:

ChunkAnArray

Suddividere una matrice in blocchi.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
elenco	array	True	array of string	elenco
Dimensioni blocco	size	True	integer	Dimensioni di ogni blocco.

Restituisce

Nome	Percorso	Tipo	Descrizione
elenco	array	array of string	elenco

Calcolare la media

ID operazione:

CalculateAverage

Calcola il valore medio di una determinata chiave.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
elenco	array	True	array of string	elenco
Key	key	True	string	Chiave per cui calcolare la media.

Restituisce

Nome	Percorso	Tipo	Descrizione
Medio	average	integer	Media calcolata per la chiave specificata.

Combinare più file PDF

ID operazione:

CombineMultiplePdfFiles

Combinare più file PDF in uno.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
pdf	pdfs	True	array of string	pdf

Restituisce

Nome	Percorso	Tipo	Descrizione
Contenuto del file	content	string	Stringa con codifica base64 dei file PDF combinati.

Combinare una matrice

ID operazione:

CombineArray

Combinare le chiavi di una matrice con i valori di un'altra matrice.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Tipo di contenuto per la richiesta.	Content-Type	True	string	Content-Type
Tipo di accettazione per la richiesta.	Accept	True	string	Accettare
Chiavi	keys	True	array of string	Chiavi
values	values	True	array of string	values

Restituisce

Nome	Percorso	Tipo	Descrizione
elenco	array	array of string	elenco

Controllare se la matrice contiene un valore

ID operazione:

CheckIfArrayContainAValue

Determina se la matrice contiene un determinato elemento.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
elenco	array	True	array of string	elenco
Key	key	True	string	Chiave in cui cercare il valore specifico.
Termine di ricerca	search	True	string	Termine di ricerca da cercare.

Restituisce

Nome	Percorso	Tipo	Descrizione
Contiene	contains	boolean	Indica se la matrice contiene o meno l'elemento specificato (bool)

Convertire un file PDF in testo

ID operazione:

ConvertAPdfFileToText

Converte un file PDF in testo.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Fine pagina	endPage		integer	Se impostata, questa è l'ultima pagina che l'azione convertirà in testo.
Output Layout	layout	True	string	Layout del contenuto di output. È possibile scegliere tra 'raw' o 'original'. L'originale manterrà il layout.
Contenuto del file	pdf	True	byte	Stringa con codifica base64 del file PDF.
Pagina iniziale	startPage		integer	Se impostata, si tratta della prima pagina che l'azione convertirà in testo.

Restituisce

Corpo

StandardArrayResponse

Convertire una stringa in un oggetto datetime

ID operazione:

ConvertAStringToADatetimeObject

Trasformare una stringa in un formato datetime valido.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Tipo di contenuto per la richiesta.	Content-Type	True	string	Content-Type
Tipo di accettazione per la richiesta.	Accept	True	string	Accettare
Formato di input	inputFormat	True	string	Formato della stringa di input.
Formato output	outputFormat	True	string	Formato di data e ora in cui deve essere convertita la stringa.
Stringa di input	string	True	string	Stringa di input da convertire in data e ora.
Timezone	timezone		string	Fuso orario in cui deve essere convertito il valore datetime (facoltativo)

Restituisce

Nome	Percorso	Tipo	Descrizione
Data/Ora	datetime	string	Nuova data trasformata

Eseguire OCR in un file PDF o immagine digitalizzato

ID operazione:

PerformOcrOnAScannedPdfOrImageFile

Sostituisce una stringa con un'altra parola.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Contenuto del file	file	True	string	Stringa con codifica base64 del file (PDF o immagine).
Language	language		string	Lingua del file di input. (default = eng)
Motore OCR (OEM)	oem	True	integer	Motore OCR da usare. (0 = legacy, 1 = LSTM)
Metodo Page Segmentation (PSM)	psm	True	integer	In che modo il OCR segmenta l'immagine di input?
Tagliare l'output	trim	True	boolean	Se abilitata, verranno rimosse tutte le interruzioni di riga e spaziatura in eccesso del testo di output.
Tipo file	type	True	string	Tipo di file di input.

Restituisce

Nome	Percorso	Tipo	Descrizione
Testo di output	text	string	Testo di output dell'azione OCR.

Filtrare una matrice per i valori false

ID operazione:

FilterAnArray

Questa azione rimuove le voci false da una matrice.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
elenco	array	True	array of string	elenco
Mantieni chiavi di matrice	preserveKeys	True	boolean	Se impostato su true, la matrice restituita manterrà le chiavi degli attributi originali.

Restituisce

Nome	Percorso	Tipo	Descrizione
elenco	array	array of string	elenco

Impostare la password in un file PDF

ID operazione:

SetPasswordOnAPdfFile

Imposta dinamicamente una password personalizzata in un file PDF.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Tipo di contenuto per la richiesta.	Content-Type	True	string	Content-Type
Tipo di accettazione per la richiesta.	Accept	True	string	Accettare
Parola chiave	password	True	string	Password da applicare al file PDF.
PDF File	pdf	True	byte	Contenuto di base64 dei file PDF.

Restituisce

Nome	Percorso	Tipo	Descrizione
Contenuto del file	content	string	Stringa con codifica Base64 del file PDF con la password.

Ordinare una matrice

ID operazione:

SortAnArray

Ordinare una matrice da alta a bassa o da decrescente a crescente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
elenco	array	True	array of string	elenco
Ordinamento	sort	True	string	Come devono essere ordinati gli elementi della matrice?

Restituisce

Corpo

StandardArrayResponse

Ottenere elementi univoci in una matrice

ID operazione:

GetUniqueItemsInAnArray

L'azione restituisce tutti gli elementi univoci in una matrice.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
elenco	array	True	array of string	elenco
Key	key		string	Chiave specifica che determina l'univocità.

Restituisce

Nome	Percorso	Tipo	Descrizione
elenco	array	array of string	elenco

Ottenere informazioni sui metadati PDF

ID operazione:

GetPdfMetadataInformation

Ottenere i metadati da un file PDF.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Contenuto del file	pdf	True	byte	Stringa con codifica base64 del file PDF.

Restituisce

Nome	Percorso	Tipo	Descrizione
Versione PDF	metadata.PDFVersion	string	PDFVersion
Autore	metadata.author	string	Autore del file PDF
Data creazione	metadata.creationDate	string	Data di creazione del file PDF.
Creatore	metadata.creator	string	Creatore del file PDF.
Crittografato	metadata.encrypted	string	Indica se il file PDF è crittografato. Restituisce "yes"/"no".
Dimensioni file	metadata.fileSize	string	Dimensioni del file PDF in byte.
Formulario	metadata.form	string	Se vengono trovati moduli nel file PDF.
Data di modifica	metadata.modDate	string	Se il file è stato modificato. (impostazione predefinita = null)
Con ottimizzazione	metadata.optimized	string	Se il file è stato ottimizzato. (impostazione predefinita = "no")
output	metadata.output	array of string	output
Rotazione pagina	metadata.pageRot	string	Rotazione del file PDF.
Dimensioni pagina	metadata.pageSize	string	Dimensioni della pagina del file PDF.
Numero di pagine	metadata.pages	string	Numero di pagine nel file PDF.
Prodotto da	metadata.producer	string	Produttore del file PDF.
Taggati	metadata.tagged	string	Indica se il file PDF è contrassegnato o meno. Restituisce "yes"/"no".
Titolo	metadata.title	string	Titolo del file PDF.

Prima posizione all'interno di una matrice

ID operazione:

FirstWhereWithinAnArray

Questa azione restituisce il primo elemento in una matrice con la coppia chiave/valore specificata.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
elenco	array	True	array of string	elenco
Key	key	True	string	Chiave da cercare.
Operator	operator		string	Eseguire una clausola operator (Facoltativo)
Cercare	value	True	string	Valore da cercare.

Restituisce

Nome	Percorso	Tipo	Descrizione
elenco	array	array of string	elenco

Raggruppa per chiave di matrice

ID operazione:

GroupByAnArrayKey

Questa azione raggruppa gli elementi di una matrice in base a una determinata chiave.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
elenco	array	True	array of string	elenco
Key	key	True	string	Chiave per raggruppare gli elementi.

Restituisce

Nome	Percorso	Tipo	Descrizione
elenco	array	array of string	elenco

Rimuovere l'elemento dalla matrice

ID operazione:

RemoveItemFromArray

Rimuove un elemento da una matrice in base al valore della chiave.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
elenco	array	True	array of string	elenco
Key	key	True	string	Gli elementi corrispondenti a questa chiave verranno rimossi.

Restituisce

Nome	Percorso	Tipo	Descrizione
elenco	array	array of string	elenco

Sostituire il testo nella stringa

ID operazione:

ReplaceTextInString

Sostituire una o più parole con un'altra parola.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Tipo di contenuto per la richiesta.	Content-Type	True	string	Content-Type
Tipo di accettazione per la richiesta.	Accept	True	string	Accettare
Sostituisci con	replace	True	string	Stringa o parola con cui sostituire la stringa trovata.
Cercare	search	True	string	Stringa o parola da trovare nella stringa di input.
Testo di input	text	True	string	Testo di input su cui eseguire la sostituzione.

Restituisce

Nome	Percorso	Tipo	Descrizione
text	text	string	text

Sostituire il testo nella stringa in base a un'espressione regolare

ID operazione:

ReplaceTextInStringBasedOnARegularExpression

Sostituire una o più parole con un'altra parola, in base a un'espressione regolare.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Modello regex	pattern	True	string	Modello di espressione regolare da usare nella ricerca.
Valore di sostituzione	replacement	True	string	Stringa con cui sostituire il valore trovato.
Testo di input	text	True	string	Stringa in cui eseguire la sostituzione del testo.

Restituisce

Nome	Percorso	Tipo	Descrizione
Testo	text	string	Stringa di testo sostituita

Trovare duplicati nelle matrici

ID operazione:

FindDuplicatesInArrays

Questa azione recupera e restituisce valori duplicati da una matrice.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
elenco	array	True	array of string	elenco
Key	key		string	È possibile specificare una chiave per cercare duplicati in un attributo specifico (facoltativo)

Restituisce

Nome	Percorso	Tipo	Descrizione
elenco	array	array of string	elenco

Trovare la differenza tra matrici

ID operazione:

FindDifferenceBetweenArrays

Questa azione confronta una matrice con un'altra matrice.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
elenco	array	True	array of string	elenco
confrontare	compare	True	array of string	confrontare

Restituisce

Nome	Percorso	Tipo	Descrizione
elenco	array	array of string	elenco

Trovare valori da una stringa basata su un'espressione regolare

ID operazione:

FindValuesFromAStringBasedOnARegularExpression

Trovare uno o più valori in una stringa.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Gruppo	group		integer	Gruppo da restituire. (impostazione predefinita = 0)
Modello regex	pattern	True	string	Modello di espressione regolare.
Testo di input	text	True	string	Stringa in cui cercare i riferimenti.

Restituisce

Nome	Percorso	Tipo	Descrizione
values	values	array of string	values

Definizioni

StandardArrayResponse

Nome	Percorso	Tipo	Descrizione
Matrice di risultati	array	array of string	Matrice contenente i nuovi elementi.