Erstellen von Datenmodellen mithilfe der API

Ein Datenmodell besteht aus einer Liste von Attributen. Das Datenmodell muss vor der Erstellung der Kampagne erstellt werden.

In diesem Beispiel wird Talend API Tester zum Senden von Requests verwendet.

Weitere Informationen zu Talend API Tester finden Sie im Nutzungshandbuch für Talend Cloud API Tester.

Prozedur

Sofern Sie noch nicht über ein persönliches Zugriffstoken verfügen, erzeugen Sie eines. Weitere Informationen finden Sie unter „Generieren persönlicher Zugriffstoken“.
Öffnen Sie Talend API Tester in Ihrem Browser.
Wählen Sie auf der Registerkarte Repository die Methode Post in der Dropdown-Liste Method (Methode) aus.
Geben Sie folgende URL ein: https://tds.{region}.cloud.talend.com/schemaservice/api/v1/schemas/org.talend.schema

Eine Liste der für die verschiedenen Rechenzentren zu verwendenden URLs finden Sie unter Talend Cloud-Regionen und -URLs.
Klicken Sie auf die Schaltfläche Add header (Header hinzufügen) und geben Sie Authorization (Autorisierung) in das Feld name (Name) und Bearer, gefolgt von einem Leerzeichen und Ihrem Token in das Feld value (Wert) ein.
Klicken Sie auf die Schaltfläche Add header (Header hinzufügen), geben Sie Cookie in das Feld name (Name) ein und lassen Sie das Feld value (Wert) leer.

Nehmen Sie in das Feld Body die Datenmodelldetails in JSON auf.

Example

Um dasselbe Datenmodell demo_product (Demoprodukt) wie in der Führung zu erstellen, verwenden Sie einen anderen Namen, beispielsweise my_products_created_via_API (Meine per API erstellten Produkte). Geben Sie dazu Folgendes ein:

{
    "name": "my_products_created_via_API",
    "displayName": "Product (created via API)",
    "description": "Product catalog available.",
    "fields": [{
        "name": "Id",
        "displayName": "Id",
        "description": "",
        "type": "integer",
        "required": true
    }, {
        "name": "Name",
        "displayName": "Name",
        "description": "",
        "type": "text",
        "required": true
    }, {
        "name": "Material",
        "displayName": "Material",
        "description": "",
        "type": "text",
        "required": true
    }, {
        "name": "Size",
        "displayName": "Size",
        "description": "",
        "type": "text",
        "required": true
    }, {
        "name": "Price",
        "displayName": "Price",
        "description": "",
        "type": "decimal",
        "required": true,
        "constraints": [{
            "name": "scaleDecimal",
            "value": 2
        }]
    }, {
        "name": "Quantity",
        "displayName": "Quantity",
        "description": "",
        "type": "integer",
        "required": true
    }, {
        "name": "Family",
        "displayName": "Family",
        "description": "",
        "type": "text",
        "required": true
    }, {
        "name": "Packaging",
        "displayName": "Packaging",
        "description": "",
        "type": "text",
        "required": true
    }, {
        "name": "ProductURL",
        "displayName": "Product URL",
        "description": "",
        "type": "URL",
        "required": true
    }, {
        "name": "productType",
        "displayName": "Type",
        "description": "",
        "type": "text",
        "required": false
    }]
}

Klicken Sie auf Send (Senden).

Ergebnisse

Die API gibt den HTTP-Code 200 zurück, um Sie darüber zu informieren, dass der Request erfolgreich war. Die Antwort enthält eine JSON-Beschreibung des erstellten Datenmodells. Beispiel:

{
    "namespace": "org.talend.schema",
    "displayName": "Product (created via API)",
    "name": "my_products_created_via_API",
    "description": "Product catalog available.",
    "version": 1,
    "references":[],
    "creationDate": 1601467434441,
    "lastUpdateDate": 1601467434441,
    "createdBy": {
        "id": "3e2eed7d-c632-40da-822e-9780f2c74842",
        "username": "user@account",
        "firstName": "user",
        "lastName": "name",
        "enabled": true
    },
    "lastUpdatedBy": {
        "id": "3e2eed7d-c632-40da-822e-9780f2c74842",
        "username": "user@account",
        "firstName": "user",
        "lastName": "name",
        "enabled": true
    },
    "fields": null,
    "referenced": false
}

Das von Ihnen erstellte Datenmodell wird in Talend Cloud Data Stewardship angezeigt.

Anmerkung: Wenn Sie versuchen, ein Datenmodell mit einem bereits vorhandenen Namen zu erstellen, gibt die API den Fehler 400 Bad request (400 Ungültiger Request) zurück. Die Antwort enthält in etwa folgende Nachricht:

{"code":"SCHEMA_ALL_SCHEMA_NAME_ALREADY_EXISTS","message":"SCHEMA_NAME_ALREADY_EXISTS","context":{"name":"demo_product"}}

Hat diese Seite Ihnen geholfen?

Wenn Sie Probleme mit dieser Seite oder ihren Inhalten feststellen – einen Tippfehler, einen fehlenden Schritt oder einen technischen Fehler –, teilen Sie uns bitte mit, wie wir uns verbessern können!

Geben Sie hier Ihr Feedback ab