Data Connectors unterstützen jetzt die Zuordnung von JSON- und XML-API-Antworten. Wenn Ihre API XML zurückgibt, wandelt Intercom es automatisch in JSON um, bevor Objekte und Arrays zugeordnet werden. Alle unten beschriebenen Zuordnungsregeln und Einschränkungen gelten für die konvertierte JSON-Struktur.
Objekte und Arrays, die Sie zuordnen können
Hinweis: Um Datumsdaten einem Datetime-Attribut in einem Custom Object zuzuordnen, unterstützen wir nur die Zuordnung von Zeichenketten im ISO 8601-Format, z. B. 2008-01-10T11:00:00-05:00
Einfaches JSON-Objekt
Sie können Root-API-Objekte Personen, Konversationen und Custom Objects zuordnen. Alle API-Attribute sind zugänglich.
{
"type": "admin",
"id": "493881",
"name": "Hoban Washburne",
"email": "wash@serenity.io",
"away_mode_enabled": false,
"away_mode_reassign": false
}
Verschachtelte JSON-Objekte
Sie können 3 API-Objekte (root, order, client_details) Personen, Konversationen und Custom Objects zuordnen. Alle API-Attribute sind zugänglich.
{
"order": {
"id": 450789469,
"admin_graphql_api_id": "gid://shopify/Order/450789469",
"app_id": null,
"browser_ip": "0.0.0.0",
"buyer_accepts_marketing": false,
"cancel_reason": null,
"cancelled_at": null,
"cart_token": "68778783ad298f1c80c3bafcddeea02f",
"checkout_id": 901414060,
"checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
"client_details": {
"accept_language": null,
"browser_height": null,
"browser_ip": "0.0.0.0",
"browser_width": null,
"session_hash": null,
"user_agent": null
}
}
}
Arrays auf oberster Ebene
Root-Objekt ist ein Array
Sie können das Root-Array einem Custom Object-Typ zuordnen. Alle API-Attribute eines Elements sind zugänglich (das erste Element wird als repräsentativ genommen).
[
{
"type": "admin",
"id": "493881",
"name": "Hoban Washburne",
"email": "wash@serenity.io",
"away_mode_enabled": false,
"away_mode_reassign": false
},
{
"type": "admin",
"email": "mal@serenity.io",
"id": "646303",
"name": "Malcolm Reynolds ",
"away_mode_enabled": true,
"away_mode_reassign": false
}
]
Verschachtelte Arrays
Sie können auf Arrays zugreifen, die in Objekten verschachtelt sind (nicht in anderen Arrays). Sie können diese Arrays Custom Objects zuordnen.
{
"order": {
"id": 450789469,
"discount_codes": [
{
"code": "TENOFF",
"amount": "10.00",
"type": "fixed_amount"
}
],
"note_attributes": [
{
"name": "custom engraving",
"value": "Happy Birthday"
},
{
"name": "colour",
"value": "green"
}
]
}
}
Arrays, die Sie nicht zuordnen können
Arrays, die in anderen Arrays verschachtelt sind
Sie können nicht auf Arrays zugreifen, die in Elementen anderer Arrays verschachtelt sind. Das liegt daran, dass wir nicht wissen, welches Element des obersten Arrays ausgewählt werden soll. Im folgenden Beispiel können Sie das order-Array einem Custom Object zuordnen, aber nicht die discount_codes-Arrays, da diese im orders-Array verschachtelt sind.
{
"orders": [
{
"id": 1,
"discount_codes": [
{
"code": "TENOFF",
"amount": "10.00",
"type": "fixed_amount"
}
],
"note_attributes": [
{
"name": "custom engraving",
"value": "Happy Birthday"
},
{
"name": "colour",
"value": "green"
}
]
},
{
"id": 2,
"discount_codes": [
{
"code": "TENOFF",
"amount": "10.00",
"type": "fixed_amount"
}
],
"note_attributes": [
{
"name": "custom engraving",
"value": "Happy Birthday"
},
{
"name": "colour",
"value": "green"
}
]
}
]
}
Verschachtelte Objekte in Anfragen senden
Data Connectors unterstützen derzeit nur das Senden von flachen (Schlüssel/Wert) Parametern in Anfrageinhalten. Verschachtelte Objekt- und Array-Parameter werden nicht unterstützt.
Das bedeutet, wenn eine Drittanbieter-API ein verschachteltes Objekt als Teil der Anfrage benötigt – zum Beispiel erfordern die Endpunkte für Bestellstornierung und Rückerstattung von Shopify ein buyer_identity-Objekt – kann die Aktion über einen Data Connector nicht erfolgreich abgeschlossen werden.
Die Unterstützung für verschachtelte Objekt- und Array-Parameter in Anfrageinhalten ist in unserer Roadmap. Wir aktualisieren diesen Artikel, sobald sie verfügbar ist.