Snaplii (wersja zapoznawcza)
Przeglądaj marki kart upominkowych Snaplii, sprawdź saldo Snaplii Cash i uzyskaj ofertę cenową przed zakupem. Wydatki pochodzą tylko z przedpłaconych Snaplii Cash.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Service | 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 | 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) |
| Contact | |
|---|---|
| Name | Snaplii Inc. |
| adres URL | https://www.snaplii.com/help-center/ |
| customerservice@snaplii.com |
| Metadane łącznika | |
|---|---|
| Publisher | Snaplii |
| Website | https://www.snaplii.com/a2m/ |
| Zasady ochrony prywatności | https://www.snaplii.com/privacy-policy/ |
| Categories | Finanse; Handel |
Snaplii
Ten łącznik pozwala Copilot Studio agentów przeglądać marki kart upominkowych Snaplii, sprawdzić saldo Snaplii Cash użytkownika i uzyskać ofertę cenową przed zakupem. Wydatki pochodzą tylko z przedpłaconych Snaplii Cash użytkownika; a quote charges nothing( Opłaty za cudzysłów).
Prerequisites
Konto Snaplii w Kanadzie lub Stany Zjednoczone i klucz interfejsu API utworzony w aplikacji Snaplii (Więcej, formy płatności, zarządzanie płatnościami sztucznej inteligencji, nowy klucz interfejsu API).
Jak uzyskać poświadczenia
Utwórz klucz interfejsu API w aplikacji Snaplii, wybierz jego zakres i limit wydatków, a następnie wprowadź go podczas tworzenia połączenia. Klucz można odwołać w aplikacji w dowolnym momencie.
Wprowadzenie do łącznika
Wyświetl listę kategorii i marek, otwórz szczegóły marki, aby wybrać kartę i kwotę, a następnie zacytować tę kartę.
Znane problemy i ograniczenia
- Dostępne tylko dla kont Snaplii w Kanadzie i Stany Zjednoczone.
- Łącznik odczytuje wykaz, saldo i oferty; nie kupuje kart upominkowych, płaci rachunki ani nie wysyła pieniędzy.
- Katalog zawiera listę marek wyświetlanych na stronie głównej aplikacji Snaplii.
- Wydatki pochodzą tylko z przedpłaconych Snaplii Cash.
- Identyfikator karty w cudzysłowie musi zostać skopiowany dokładnie ze szczegółów marki.
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Wartość domyślna
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
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 | Opis | Required |
|---|---|---|---|
| Klucz interfejsu API Snaplii | securestring | Klucz interfejsu API Snaplii dla tego interfejsu API | True |
Akcje
| Get Snaplii Cash balance |
Saldo znajduje się w walucie konta (CA=CAD, US=USD), kraju zwróconego przy użyciu tokenu dostępu. |
| Lista kategorii kart upominkowych i marek |
Wykaz jest o określonym zakresie w kraju uwierzytelnionych kont. Nie jest wysyłany parametr locationProv. |
| Oferty zakupu karty upominkowej |
Zacytuj zakup karty upominkowej. Przed cytowaniem przeczytaj szczegóły marki i potwierdź identyfikator karty i kwotę pasują do jednego z jego nominałów. Dodatnia podstawowaPayAmount oznacza Snaplii Cash nie obejmuje w pełni zamówienia. Nic nie jest obciążane cytatem. |
| Pobieranie szczegółów i nominałów marki karty prezentowej |
Zwraca karty marki i ich nominały. Naprawiono wymaga dokładnej cenyStart; Zmienna wymaga kwoty między priceStart i priceEnd. |
Get Snaplii Cash balance
Saldo znajduje się w walucie konta (CA=CAD, US=USD), kraju zwróconego przy użyciu tokenu dostępu.
Zwraca
Saldo, zwrócone bezpośrednio lub w obszarze danych, w walucie konta.
- Body
- BalanceResponse
Lista kategorii kart upominkowych i marek
Wykaz jest o określonym zakresie w kraju uwierzytelnionych kont. Nie jest wysyłany parametr locationProv.
Zwraca
Kategorie wyświetlane na stronie głównej aplikacji Snaplii.
- Body
- CatalogResponse
Oferty zakupu karty upominkowej
Zacytuj zakup karty upominkowej. Przed cytowaniem przeczytaj szczegóły marki i potwierdź identyfikator karty i kwotę pasują do jednego z jego nominałów. Dodatnia podstawowaPayAmount oznacza Snaplii Cash nie obejmuje w pełni zamówienia. Nic nie jest obciążane cytatem.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
itemId
|
itemId | True | string |
Identyfikator karty upominkowej, dokładnie {cardBrandId}-{cardTemplateId}: karta markiBrandId, jeden łącznik i karta wybranej kartyTemplateId, oba skopiowane z szczegółów marki. Nigdy nie wysyłaj jednego identyfikatora, karty z innej marki lub odgadnięcia identyfikatora. |
|
price
|
price | True | string |
Kwota dziesiętna wysłana jako ciąg JSON w walucie konta. |
|
voucherOption
|
voucherOption | True | string | |
|
cashOption
|
cashbackOption | True | string | |
|
specifiedVoucher
|
specifiedVoucher | string |
Identyfikator konkretnego kuponu. Ustaw kuponOption na użycie podczas wybierania kuponu. |
Zwraca
Kwoty ofert. primaryPayAmount jest resztą po zastosowaniu funduszy/rabatów; zero nie oznacza, że zamówienie jest bezpłatne.
- Body
- QuoteResponse
Pobieranie szczegółów i nominałów marki karty prezentowej
Zwraca karty marki i ich nominały. Naprawiono wymaga dokładnej cenyStart; Zmienna wymaga kwoty między priceStart i priceEnd.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator marki karty
|
card_brand_id | True | string |
Identyfikator marki karty. |
Zwraca
Marka, zwrócona bezpośrednio lub pod danymi.
- Body
- CardBrandResponse
Definicje
GatewayObject
Obiekt bramy.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
|
object |
Obiekt bramy. |
CatalogResponse
Kategorie wyświetlane na stronie głównej aplikacji Snaplii.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
categories
|
categories | array of GatewayObject |
Kategorie z ich markami. |
AmountValue
FaceValueRules
FIXED używa priceStart jako dokładnego nominału. ZMIENNA używa wartości priceStart i priceEnd jako granic inkluzywnych.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
typ
|
type | string | |
|
priceStart
|
priceStart | AmountValue |
Kwota lub stawka jako ciąg lub liczba. |
|
priceEnd
|
priceEnd | AmountValue |
Kwota lub stawka jako ciąg lub liczba. |
CardTemplate
Szablon karty; wartości rabatu to procenty rabatu.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
cardTemplateId
|
cardTemplateId | string | |
|
faceValueRules
|
faceValueRules | FaceValueRules |
FIXED używa priceStart jako dokładnego nominału. ZMIENNA używa wartości priceStart i priceEnd jako granic inkluzywnych. |
|
rabat
|
discount | AmountValue |
Kwota lub stawka jako ciąg lub liczba. |
|
regularDiscount
|
regularDiscount | AmountValue |
Kwota lub stawka jako ciąg lub liczba. |
CardBrand
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
cardBrandId
|
cardBrandId | string | |
|
Karty
|
cards | array of CardTemplate |
CardBrandResponse
Marka, zwrócona bezpośrednio lub pod danymi.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
cardBrandId
|
cardBrandId | string | |
|
Karty
|
cards | array of CardTemplate | |
|
dane
|
data | CardBrand |
BalanceResponse
Saldo, zwrócone bezpośrednio lub w obszarze danych, w walucie konta.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
saldo
|
balance | AmountValue |
Kwota lub stawka jako ciąg lub liczba. |
|
saldo
|
data.balance | AmountValue |
Kwota lub stawka jako ciąg lub liczba. |
QuoteResponse
Kwoty ofert. primaryPayAmount jest resztą po zastosowaniu funduszy/rabatów; zero nie oznacza, że zamówienie jest bezpłatne.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
orderAmount
|
orderAmount | AmountValue |
Kwota lub stawka jako ciąg lub liczba. |
|
primaryPayAmount
|
primaryPayAmount | AmountValue |
Kwota lub stawka jako ciąg lub liczba. |
|
voucherAmount
|
voucherAmount | AmountValue |
Kwota lub stawka jako ciąg lub liczba. |
|
cashUseAmount
|
cashbackUseAmount | AmountValue |
Kwota lub stawka jako ciąg lub liczba. |
|
voucherName
|
voucherName | string |