EasyPost Mail (wersja zapoznawcza)
Technologia Bing umożliwia wysyłanie poczty pocztowej, poczty e-mail, wiadomości SMS i faksu bezpośrednio z komputera jednym kliknięciem. Interfejs API EasyPost umożliwia automatyczne, uwierzytelnione przekazywanie do usług komunikacyjnych Bing, obsługę pojedynczych lub wsadowych dokumentów z metadanymi — dostarczanych ręcznie lub automatycznie wyodrębnionych. Po przekazaniu systemy Bing weryfikują, przetwarzają, drukują i przesyłają pocztę. Do użycia jest wymagane konto Bing. Aby uzyskać szczegółowe informacje, zobacz www.bingmail.com.au.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate - narzędzie do automatyzacji procesów | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Obsługa Bing |
| adres URL | https://help.bingmail.com.au/ |
| customerservice@bingmail.com.au |
| Metadane łącznika | |
|---|---|
| Publisher | Technologie Bing |
| Dokumentacja interfejsu API | https://docs.microsoft.com/connectors/easypostdocumentatio |
| Witryna internetowa | https://www.bingmail.com.au/ |
| Zasady ochrony prywatności | https://bingmail.com.au/privacy-policy |
| Kategorie | Operacje IT |
| connectionDisplayName (nazwa_wyświetlana) | Połączenie EasyPost |
| connectionDescription | Nawiązywanie połączenia z usługą Easypost przy użyciu poświadczeń konta |
Łącznik EasyPost Bing
Interfejs API EasyPost zapewnia automatyczne bezpośrednie przekazywanie dokumentów do usług komunikacyjnych Bing. Interfejs API ustanawia uwierzytelnionej sesji zezwalającej na przekazywanie dokumentu lub zestawu dokumentów i skojarzonych metadanych. Po zakończeniu sesji systemy wspierane przez usługę Bing będą weryfikować, przetwarzać, drukować i składać pocztę. Informacje dotyczące adresowania są udostępniane interfejsowi API za pośrednictwem pliku metadanych lub alternatywnie procesor automatyczny może wyodrębnić adres i inne metadane z dokumentów.
Publisher
Ten łącznik jest zarządzany i publikowany przez firmę Bing Technologies Pty Ltd
Wymagania wstępne
Aby korzystać z łącznika EasyPost, potrzebne są następujące elementy:
- Plan usługi Microsoft Power Apps lub Power Automate
- Konto klienta Bing
- Prawidłowy klucz interfejsu API EasyPost
Obsługiwane operacje
Łącznik obsługuje następujące operacje:
-
Get session ID: Uzyskaj identyfikator sesji przy użyciu kodu konta Bing i dołączonego połączenia uwierzytelniania podstawowego, zażądano identyfikatora sesji. Używa to żądania HTTP GET do "publicinterface/get_session_id.json". Spowoduje to zwrócenie identyfikatora sesji (EPID) w formacie JSON. -
Upload files: Przekaż metadane i dokument Przy użyciu podanego identyfikatora sesji adres URL jest tworzony do przekazywania plików przy użyciu żądania HTTP PUT. W sesji można przekazać wiele plików, wykonując dowolną liczbę kroków przekazywania plików . -
End session: Zakończ sesję Zakończ sesję z innym żądaniem HTTP GET do punktu końcowego "publicinterface/end_session.json" z podanym identyfikatorem sesji. Spowoduje to zwrócenie stanu i listy plików, które zostały pomyślnie odebrane. Spowoduje to wyzwolenie przetwarzania zaplecza przekazanych zasobów. Przesłane listy będą wyświetlane w portalu klienta Bing, które można zidentyfikować przy użyciu identyfikatora sesji.
Typowy przykład:
[Get Session ID] --> [Upload files] --> [End session]
Authentication
Zaplecze EasyPost wymaga teraz uwierzytelniania klucza interfejsu API. Uwierzytelnianie podstawowe nazwy użytkownika/hasła nie działa obecnie w interfejsie łącznika Power Automate Monit o utworzenie połączenia przy użyciu prawidłowych poświadczeń usługi Bing pojawi się podczas dodawania tego łącznika jako nowego kroku po raz pierwszy.
Użycie tokenu interfejsu API
Aby użyć metody uwierzytelniania interfejsu API, upewnij się, że poświadczenia są poprzedzane przy użyciu polecenia Bearer. Podczas tworzenia nowego połączenia powinien wyglądać następująco:
| Nazwa połączenia * | Poświadczenia interfejsu API Bingmail Johna Smitha |
| Typ uwierzytelniania * | Uwierzytelnianie klucza interfejsu API |
| Klucz interfejsu API * | Bearer f4fee615-62e4-4ed4-9364-1210f3a2df2c |
Znane problemy i ograniczenia
| Produkt | Description |
|---|---|
| Uwierzytelnianie szyfrowane | Uwierzytelnianie szyfrowane jest obsługiwane (i preferowane) dla tego interfejsu API, jednak łączniki niestandardowe usługi Power Automate nie obsługują obecnie gotowego uwierzytelniania szyfrowego. |
| multipart/form-data | Inną metodą bezpośredniego przekazywania plików do systemu EasyPost jest metoda formularzy Multipart, jednak łączniki niestandardowe usługi Power Automate nie obsługują tego obecnie. |
| Zakończenie sesji 200 OK | W przypadku korzystania z End session akcji, jeśli po podaniu nieprawidłowego identyfikatora sesji system zwróci 200 OK, ale z treścią: "error": "unknown session" |
| Problem z akcjami typu GET | Usługa Power Automate, w tym nieprawidłowy typ treści dla żądań typu GET. Rozwiązano problem w wersji 1.0.4 |
| Problem z uwierzytelnianiem 401 | Nieprawidłowe przesłanie poświadczeń do zaplecza podczas tworzenia błędów fałszywie dodatnich 401. Rozwiązano problem w wersji 1.1.0 |
Wersja: 1.1.1
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Uwierzytelnianie podstawowe | Zaloguj się przy użyciu nazwy użytkownika i hasła usługi Bing. | Wszystkie regiony | Nie można udostępniać |
| Domyślne [PRZESTARZAŁE] | Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami. | Wszystkie regiony | Nie można udostępniać |
uwierzytelnianie podstawowe
Identyfikator uwierzytelniania: uwierzytelnianie podstawowe
Dotyczy: wszystkie regiony
Zaloguj się przy użyciu nazwy użytkownika i hasła usługi Bing.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagania |
|---|---|---|---|
| Nazwa użytkownika | ciąg | Prawda | |
| Hasło | securestring | Prawda |
Domyślne [PRZESTARZAŁE]
Dotyczy: wszystkie regiony
Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Przekaż pliki |
Przekazywanie pojedynczego pliku przy użyciu prawidłowego identyfikatora sesji |
| Uzyskiwanie identyfikatora sesji |
Uzyskiwanie prawidłowego identyfikatora sesji w celu rozpoczęcia przekazywania plików |
| Zakończ sesję |
Zakończ prawidłową sesję, kończąc przekazywanie, aby rozpocząć drukowanie lub wysyłanie. |
Przekaż pliki
Przekazywanie pojedynczego pliku przy użyciu prawidłowego identyfikatora sesji
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sesji
|
session_id | True | string |
Identyfikator sesji do przekazywania plików do |
|
Filename
|
file_name | True | string |
Nazwa pliku (rozszerzenie pliku incl) |
|
Zawartość pliku
|
fileContent | True | binary |
Uzyskiwanie identyfikatora sesji
Uzyskiwanie prawidłowego identyfikatora sesji w celu rozpoczęcia przekazywania plików
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kod konta Bing
|
account | True | string |
Kod konta Bing skojarzony z żądaniem. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Nazwa użytkownika
|
user | string |
Nazwa użytkownika skojarzona z żądaniem. |
|
Identyfikator konta
|
account | string |
Identyfikator konta Bing skojarzony z żądaniem. |
|
Identyfikator sesji
|
session_id | string |
Identyfikator utworzonej sesji |
Zakończ sesję
Zakończ prawidłową sesję, kończąc przekazywanie, aby rozpocząć drukowanie lub wysyłanie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sesji
|
session_id | True | string |
Identyfikator sesji dla sesji, którą chcesz zakończyć. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator sesji
|
session_id | string |
Identyfikator zakończonej sesji |
|
Wynik sesji
|
result | string |
Końcowy wynik sesji (OK, BRAK PLIKÓW itp.) |
|
stan
|
status | string | |
|
files
|
files | array of object | |
|
Filename
|
files.name | string |
Przekazana nazwa pliku |
|
|
files.sz | integer |
Rozmiar przekazanego pliku |
|
Rozmiar przekazywania
|
files.upld_sz | integer | |
|
cl_sz
|
files.cl_sz | integer | |
|
Kawałki
|
files.chunks | integer | |
|
intencja
|
files.intent | integer | |
|
pierwszy
|
files.first | double | |
|
last
|
files.last | double | |
|
gospodarz
|
files.host | string |
Żądanie obsługi hosta wewnętrznego |
|
apath
|
files.apath | string | |
|
gpath
|
files.gpath | string | |
|
sha1
|
files.sha1 | string | |
|
błąd
|
error | string |
Żądanie nie powiodło się, zazwyczaj nieznana sesja. |
|
błędy
|
errs | array of string |