EasyPost Mail (Preview)
Technologie Bingu umožňují odesílat poštovní poštu, e-mail, SMS a fax přímo z počítače jediným kliknutím. Rozhraní EasyPost API umožňuje automatizované ověřené nahrávání do komunikačních služeb Bingu, které podporuje jednoúčelové nebo dávkové dokumenty s metadaty – buď poskytnuté ručně, nebo automaticky extrahované. Po nahrání systémy Bing ověří, zpracuje, vytiskne a odešle vaši poštu. Pro použití se vyžaduje účet Bing. Podrobnosti najdete v tématuwww.bingmail.com.au.
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logické aplikace | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure Government – Oblasti Azure China - Ministerstvo obrany USA (DoD) |
| Power Apps | Premium | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Automatizace napájení | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Název | Podpora Bingu |
| URL | https://help.bingmail.com.au/ |
| customerservice@bingmail.com.au |
| Metadata konektoru | |
|---|---|
| Vydavatel | Technologie Bingu |
| Dokumentace k rozhraní API | https://docs.microsoft.com/connectors/easypostdocumentatio |
| Internetová stránka | https://www.bingmail.com.au/ |
| Zásady ochrany osobních údajů | https://bingmail.com.au/privacy-policy |
| Kategorie | IT provoz |
| connectionDisplayName | Připojení EasyPost |
| connectionDescription | Připojení k Easypostu pomocí přihlašovacích údajů k účtu |
Konektor Snadného příspěvku Bingu
Rozhraní EasyPost API poskytuje automatizované přímé nahrávání dokumentů do komunikačních služeb Bingu. Rozhraní API vytvoří ověřenou relaci umožňující nahrání dokumentu nebo sady dokumentů a přidružených metadat. Po dokončení relace budou systémy s podporou Bingu ověřovat, zpracovávat, tisknout a zasílat poštu. Adresování informací se poskytuje rozhraní API prostřednictvím souboru metadat nebo případně může automatický procesor extrahovat adresu a další metadata z dokumentů.
Vydavatel
Tento konektor spravuje a publikoval Bing Technologies Pty Ltd.
Požadavky
Pokud chcete použít konektor EasyPost, budete potřebovat:
- Plán Microsoft Power Apps nebo Power Automate
- Zákaznický účet Bingu
- Platný klíč rozhraní API EasyPost
Podporované operace
Konektor podporuje následující operace:
-
Get session ID: Získejte ID relace pomocí kódu účtu Bing a připojeného základního připojení ověřování, vyžaduje se ID relace. To používá požadavek HTTP GET na "publicinterface/get_session_id.json". Tím se vrátí ID relace (EPID) ve formátu JSON. -
Upload files: Nahrání metadat a dokumentu pomocí zadaného ID relace se vytvoří adresa URL pro nahrání souborů pomocí požadavku HTTP PUT. V relaci se dá nahrát více souborů pomocí tolik kroků pro nahrání souborů , kolik je potřeba. -
End session: Ukončete relaci ukončením relace jiným požadavkem HTTP GET na koncový bod publicinterface/end_session.jsons zadaným ID relace. Tím se vrátí stav a seznam souborů, které byly úspěšně přijaty. Pak aktivuje zpracování back-endu nahraných prostředků. Odeslané dopisy se zobrazí na zákaznickém portálu Bingu, které lze identifikovat podle ID relace.
Typický příklad:
[Get Session ID] --> [Upload files] --> [End session]
Autentizace
Back-end EasyPost teď vyžaduje ověření klíče rozhraní API. Základní ověřování pomocí uživatelského jména a hesla v současné době není funkční v rozhraní konektoru Power Automate Výzva k vytvoření připojení pomocí platných přihlašovacích údajů Bingu se zobrazí při prvním přidání tohoto konektoru jako nového kroku.
Využití tokenu rozhraní API
Pokud chcete použít metodu ověřování rozhraní API, ujistěte se, že jste přihlašovací údaje Bearerpředem použili . Při vytváření nového připojení by mělo vypadat takto:
| Název připojení * | Přihlašovací údaje rozhraní API Bingmailu pro John Smith |
| Typ ověřování * | Ověřování pomocí klíče rozhraní API |
| Klíč rozhraní API * | Nosný f4fee615-62e4-4ed4-9364-1210f3a2df2c |
Známé problémy a omezení
| Položka | Description |
|---|---|
| Ověřování hodnotou hash | Pro toto rozhraní API se podporuje ověřování hodnotou hash (a preferuje se), ale vlastní konektory Power Automate v současné době nepodporují ověřování hodnotou hash. |
| multipart/form-data | Další metodou přímého nahrávání souborů do systému EasyPost je metoda formuláře s více částmi, ale vlastní konektory Power Automate to v současné době nepodporují. |
| Ukončení relace 200 OK | Pokud při použití End session akce zadáte neplatné ID relace, systém vrátí hodnotu 200 OK, ale s textem: "error": "unknown session" |
| Problém s akcemi typu GET | Power Automate včetně neplatného typu těla při žádostech o typ GET Vyřešeno ve verzi 1.0.4 |
| Problém s ověřováním 401 | Nesprávné odeslání přihlašovacích údajů do našeho back-endu vytvářející falešně pozitivní chyby 401. Vyřešeno ve verzi 1.1.0 |
Verze: 1.1.1
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| Základní ověřování | Přihlaste se pomocí uživatelského jména a hesla pro Bing. | Všechny oblasti | Nesdílitelné |
| Výchozí [ZASTARALÉ] | Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze pro zpětnou kompatibilitu. | Všechny oblasti | Nesdílitelné |
Základní ověřování
ID ověřování: základní ověřování
Použitelné: Všechny oblasti
Přihlaste se pomocí uživatelského jména a hesla pro Bing.
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Název | Typ | Description | Povinné |
|---|---|---|---|
| Uživatelské jméno | řetězec | Pravdivé | |
| Heslo | securestring | Pravdivé |
Výchozí [ZASTARALÉ]
Použitelné: Všechny oblasti
Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze pro zpětnou kompatibilitu.
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 100 | 60 sekund |
Akce
| Nahrání souborů |
Nahrání jednoho souboru pomocí platného ID relace |
| Ukončit relaci |
Ukončete platnou relaci a dokončením nahrávání začněte tisknout nebo odesílat. |
| Získání ID relace |
Získání platného ID relace pro zahájení nahrávání souborů |
Nahrání souborů
Nahrání jednoho souboru pomocí platného ID relace
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID relace
|
session_id | True | string |
ID relace pro nahrání souborů do |
|
Jméno souboru
|
file_name | True | string |
Název souboru (včetně rozsahu souborů) |
|
Obsah souboru
|
fileContent | True | binary |
Ukončit relaci
Ukončete platnou relaci a dokončením nahrávání začněte tisknout nebo odesílat.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID relace
|
session_id | True | string |
ID relace relace, kterou chcete ukončit. |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID relace
|
session_id | string |
ID ukončené relace |
|
Výsledek relace
|
result | string |
Konečný výsledek relace (OK, ŽÁDNÉ SOUBORY atd.) |
|
stav
|
status | string | |
|
files
|
files | array of object | |
|
Jméno souboru
|
files.name | string |
Nahraný název souboru |
|
|
files.sz | integer |
Velikost nahraného souboru |
|
Velikost nahrávání
|
files.upld_sz | integer | |
|
cl_sz
|
files.cl_sz | integer | |
|
polena
|
files.chunks | integer | |
|
záměr
|
files.intent | integer | |
|
první
|
files.first | double | |
|
last
|
files.last | double | |
|
hostitel
|
files.host | string |
Požadavek na zpracování interního hostitele |
|
apath
|
files.apath | string | |
|
gpath
|
files.gpath | string | |
|
sha1
|
files.sha1 | string | |
|
chyba
|
error | string |
Požadavek selhal, obvykle neznámá relace. |
|
errs
|
errs | array of string |
Získání ID relace
Získání platného ID relace pro zahájení nahrávání souborů
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Kód účtu Bing
|
account | True | string |
Kód účtu Bingu přidružený k žádosti. |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Uživatelské jméno
|
user | string |
Uživatelské jméno přidružené k požadavku. |
|
ID účtu
|
account | string |
ID účtu Bingu přidružené k žádosti. |
|
ID relace
|
session_id | string |
ID vytvořené relace |