Snaplii (Vorschau)
Durchsuchen Sie Snaplii Geschenkgutscheinmarken, überprüfen Sie Ihren Snaplii Cash-Saldo, und erhalten Sie ein Preisangebot vor dem Kauf. Ausgaben stammen nur aus Ihrem prepaid Snaplii Cash.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logic Apps | Standard | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - Azure Government Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Snaplii Inc. |
| URL | https://www.snaplii.com/help-center/ |
| E‑Mail | customerservice@snaplii.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Snaplii |
| Website | https://www.snaplii.com/a2m/ |
| Datenschutzrichtlinie | https://www.snaplii.com/privacy-policy/ |
| Categories | Finanzieren; Handel |
Snaplii
Mit diesem Connector können Copilot Studio Agenten Snaplii Geschenkkartenmarken durchsuchen, den Snaplii Cash-Saldo des Benutzers überprüfen und vor dem Kauf ein Preisangebot erhalten. Ausgaben stammen nur aus dem im Voraus bezahlten Snaplii Cash des Benutzers; ein Anführungszeichen berechnet nichts.
Prerequisites
Ein Snaplii-Konto in Kanada oder die USA und ein API-Schlüssel, der in der Snaplii-App erstellt wurde (Mehr, Zahlungsmethoden, AI-Zahlungsverwaltung, neuer API-Schlüssel).
So erhalten Sie Anmeldeinformationen
Erstellen Sie den API-Schlüssel in der Snaplii-App, wählen Sie den Umfang und das Ausgabenlimit aus, und geben Sie ihn ein, wenn Sie die Verbindung erstellen. Der Schlüssel kann jederzeit in der App widerrufen werden.
Erste Schritte mit Ihrem Connector
Listen Sie die Kategorien und Marken auf, öffnen Sie die Details einer Marke, um eine Karte und einen Betrag zu wählen, und geben Sie diese Karte an.
Bekannte Probleme und Einschränkungen
- Verfügbar für Snaplii-Konten in Kanada und nur für die USA.
- Der Verbinder liest den Katalog, den Saldo und die Anführungszeichen; Es kauft keine Geschenkgutscheine, zahlt Rechnungen oder sendet Geld.
- Der Katalog listet die Marken auf der Snaplii-App-Startseite auf.
- Ausgaben stammen nur aus prepaid Snaplii Cash.
- Die Karten-ID in einem Zitat muss genau aus den Markendetails kopiert werden.
Eine Verbindung wird erstellt
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Standard | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Standard
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Required |
|---|---|---|---|
| Snaplii-API-Schlüssel | securestring | Der Snaplii-API-Schlüssel für diese API | True |
Aktionen
| Abrufen von Markendetails und Bezeichnungen für Geschenkkarten |
Gibt die Karten der Marke und deren Bezeichnungen zurück. FIXED erfordert den genauen PreisStart; VARIABLE erfordert einen Betrag zwischen priceStart und priceEnd. |
| Angebot eines Geschenkgutscheinkaufs |
Geben Sie einen Geschenkgutscheinkauf an. Lesen Sie vor dem Zitieren die Markendetails, und bestätigen Sie die Karten-ID und den Betrag mit einer ihrer Bezeichnungen. Ein positives primaryPayAmount bedeutet, dass Snaplii Cash die Bestellung nicht vollständig abdeckt. Nichts wird durch ein Angebot in Rechnung gestellt. |
| Geschenkgutscheinkategorien und Marken auflisten |
Der Katalog ist auf das Land des authentifizierten Kontos eingegrenzt. Es wird kein parameter locationProv gesendet. |
| Snaplii Cash-Saldo erhalten |
Der Saldo befindet sich in der Kontowährung (CA=CAD, US=USD), das Land, das mit dem Zugriffstoken zurückgegeben wird. |
Abrufen von Markendetails und Bezeichnungen für Geschenkkarten
Gibt die Karten der Marke und deren Bezeichnungen zurück. FIXED erfordert den genauen PreisStart; VARIABLE erfordert einen Betrag zwischen priceStart und priceEnd.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kartenmarken-ID
|
card_brand_id | True | string |
Kartenmarkenbezeichner. |
Gibt zurück
Die Marke, die direkt oder unter Daten zurückgegeben wird.
- Body
- CardBrandResponse
Angebot eines Geschenkgutscheinkaufs
Geben Sie einen Geschenkgutscheinkauf an. Lesen Sie vor dem Zitieren die Markendetails, und bestätigen Sie die Karten-ID und den Betrag mit einer ihrer Bezeichnungen. Ein positives primaryPayAmount bedeutet, dass Snaplii Cash die Bestellung nicht vollständig abdeckt. Nichts wird durch ein Angebot in Rechnung gestellt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Artikel-ID
|
itemId | True | string |
Die Geschenkkarten-ID, genau {cardBrandId}-{cardTemplateId}: die cardBrandId der Marke, ein Bindestrich und die cardTemplateId der ausgewählten Karte, beide wurden aus den Markendetails kopiert. Senden Sie niemals eine ID allein, eine Karte von einer anderen Marke oder eine erratene ID. |
|
Preis
|
price | True | string |
Dezimalbetrag, der als JSON-Zeichenfolge in der Kontowährung gesendet wird. |
|
voucherOption
|
voucherOption | True | string | |
|
cashbackOption
|
cashbackOption | True | string | |
|
specifiedVoucher
|
specifiedVoucher | string |
Spezifische Gutschein-ID. Legen Sie "voucherOption" auf "USE" fest, wenn Sie einen Gutschein auswählen. |
Gibt zurück
Kursbeträge. primaryPayAmount ist der Rest nach angewendeten Fonds/Rabatten; Null bedeutet nicht, dass die Bestellung kostenlos ist.
- Body
- QuoteResponse
Geschenkgutscheinkategorien und Marken auflisten
Der Katalog ist auf das Land des authentifizierten Kontos eingegrenzt. Es wird kein parameter locationProv gesendet.
Gibt zurück
Die kategorien, die auf der Snaplii-App-Startseite angezeigt werden.
- Body
- CatalogResponse
Snaplii Cash-Saldo erhalten
Der Saldo befindet sich in der Kontowährung (CA=CAD, US=USD), das Land, das mit dem Zugriffstoken zurückgegeben wird.
Gibt zurück
Der Saldo, der direkt oder unter Daten zurückgegeben wird, in der Kontowährung.
- Body
- BalanceResponse
Definitionen
GatewayObject
Ein Gatewayobjekt.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
|
object |
Ein Gatewayobjekt. |
CatalogResponse
Die kategorien, die auf der Snaplii-App-Startseite angezeigt werden.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
categories
|
categories | array of GatewayObject |
Kategorien mit ihren Marken. |
AmountValue
Ein Betrag oder eine Rate als Zeichenfolge oder Zahl.
Ein Betrag oder eine Rate als Zeichenfolge oder Zahl.
FaceValueRules
FIXED verwendet "priceStart" als genauen Nennwert. VARIABLE verwendet "priceStart" und "priceEnd" als inklusive Grenzen.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
type
|
type | string | |
|
priceStart
|
priceStart | AmountValue |
Ein Betrag oder eine Rate als Zeichenfolge oder Zahl. |
|
priceEnd
|
priceEnd | AmountValue |
Ein Betrag oder eine Rate als Zeichenfolge oder Zahl. |
CardTemplate
Eine Kartenvorlage; Rabattwerte sind Cashback-Prozentsätze.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
cardTemplateId
|
cardTemplateId | string | |
|
faceValueRules
|
faceValueRules | FaceValueRules |
FIXED verwendet "priceStart" als genauen Nennwert. VARIABLE verwendet "priceStart" und "priceEnd" als inklusive Grenzen. |
|
Rabatt
|
discount | AmountValue |
Ein Betrag oder eine Rate als Zeichenfolge oder Zahl. |
|
regularDiscount
|
regularDiscount | AmountValue |
Ein Betrag oder eine Rate als Zeichenfolge oder Zahl. |
CardBrand
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
cardBrandId
|
cardBrandId | string | |
|
Karten
|
cards | array of CardTemplate |
CardBrandResponse
Die Marke, die direkt oder unter Daten zurückgegeben wird.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
cardBrandId
|
cardBrandId | string | |
|
Karten
|
cards | array of CardTemplate | |
|
data
|
data | CardBrand |
BalanceResponse
Der Saldo, der direkt oder unter Daten zurückgegeben wird, in der Kontowährung.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Gleichgewicht
|
balance | AmountValue |
Ein Betrag oder eine Rate als Zeichenfolge oder Zahl. |
|
Gleichgewicht
|
data.balance | AmountValue |
Ein Betrag oder eine Rate als Zeichenfolge oder Zahl. |
QuoteResponse
Kursbeträge. primaryPayAmount ist der Rest nach angewendeten Fonds/Rabatten; Null bedeutet nicht, dass die Bestellung kostenlos ist.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
orderAmount
|
orderAmount | AmountValue |
Ein Betrag oder eine Rate als Zeichenfolge oder Zahl. |
|
primaryPayAmount
|
primaryPayAmount | AmountValue |
Ein Betrag oder eine Rate als Zeichenfolge oder Zahl. |
|
voucherAmount
|
voucherAmount | AmountValue |
Ein Betrag oder eine Rate als Zeichenfolge oder Zahl. |
|
cashbackUseAmount
|
cashbackUseAmount | AmountValue |
Ein Betrag oder eine Rate als Zeichenfolge oder Zahl. |
|
voucherName
|
voucherName | string |