1. Hilfe
  2. Wie man über die API mit sender-solutions.com arbeitet
  3. 2. Bearbeiten eines Abonnenten mithilfe der API

2. Bearbeiten eines Abonnenten mithilfe der API

2. Bearbeiten eines Abonnenten mithilfe der API

Die Methode ist zum Bearbeiten eines vorhandenen Abonnenten im Projekt vorgesehen. Die Daten werden im Format application/json übergeben.

HTTP-Anfrage
  • URL: https://sender-solutions.com/api/subscribers/edit-subscriber/
  • HTTP-Methode: POST
  • Content-Type: application/json
Anfragetext (JSON)
{
    "Subscriber": {
        "Id": 23,
        "Base": {
            "Id": 0,
            "Name": "Test Users"
        },
        "IsActive": true,
        "Email": "username@example.com",
        "FirstName": "Cat",
        "LastName": "Catstone",
        "Gender": "male",
        "Phone": "+380111222333",
        "Tags": ["api", "test-user"],
        "ClientUserId": "ClientUserId3",
        "CustomField1": "CustomValue1",
        "CustomField2": "CustomValue2",
        "CustomField3": "CustomValue3",
        "Address": {
            "Country": "UA",
            "City": "Odesa",
            "State": null,
            "Zip": 65000,
            "Line1": "Very Long street",
            "Line2": "building 42",
            "Line3": null
        },
        "Birthday": "2002-04-15"
    }
}
Beispiel einer Anfrage unter Verwendung von cURL

curl --location 'https://sender-solutions.com/api/subscribers/edit-subscriber/' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{api-token}}' \
--data-raw '{
    "Subscriber": {
        "Id": 23,
        "Base": {
            "Id": 0,
            "Name": "Test Users"
        },
        "IsActive": true,
        "Email": "username@example.com",
        "FirstName": "Cat",
        "LastName": "Catstone",
        "Gender": "male",
        "Phone": "+380111222333",
        "Tags": ["api", "test-user"],
        "ClientUserId": "ClientUserId12345",
        "CustomField1": "CustomValue1",
        "CustomField2": "CustomValue2",
        "CustomField3": "CustomValue3",
        "Address": {
            "Country": "UA",
            "City": "Odesa",
            "State": null,
            "Zip": 65000,
            "Line1": "Very Long street",
            "Line2": "building 42",
            "Line3": null
        },
        "Birthday": "2002-04-15"
    }
}'
Beschreibung der Felder
Feld Typ Obligatorisch Beschreibung
Subscriber.Id number Kennung des Abonnenten
Subscriber.Base.Id number Kennung der Abonnentenbasis. Dieses Feld oder Subscriber.Base.Name muss zwingend angegeben werden. Wenn in beide Felder nicht leere Werte übergeben werden, wird Subscriber.Base.Id der Vorrang gegeben
Subscriber.Base.Name string Name der Abonnentenbasis. Dieses Feld oder Subscriber.Base.Id muss zwingend angegeben werden. Wenn in beide Felder nicht leere Werte übergeben werden, wird Subscriber.Base.Id der Vorrang gegeben
Subscriber.IsActive boolean Aktivitäts-Flag des Abonnenten. Standardmäßig false
Subscriber.Email string E-Mail des Abonnenten
Subscriber.FirstName string Vorname
Subscriber.LastName string Nachname
Subscriber.Gender string Geschlecht des Abonnenten. Mögliche Werte: "male" — männlich, "female" — weiblich, "" (leere Zeichenkette) — «Nicht angegeben». Standardmäßig — «Nicht angegeben»
Subscriber.Phone string Telefonnummer
Subscriber.Tags array[string] Tags des Abonnenten, Array von Zeichenketten
Subscriber.ClientUserId string ID des Abonnenten im System des Kunden
Subscriber.CustomField1 string Freies Feld 1. Füllen Sie es mit beliebigen Informationen nach eigenem Ermessen aus.
Subscriber.CustomField2 string Freies Feld 2. Füllen Sie es mit beliebigen Informationen nach eigenem Ermessen aus.
Subscriber.CustomField3 string Freies Feld 3. Füllen Sie es mit beliebigen Informationen nach eigenem Ermessen aus.
Subscriber.Address.Country string Zweistelliger Ländercode (ISO 3166-1 alpha-2)
Subscriber.Address.City string Stadt
Subscriber.Address.State string | null Region / Staat / Gebiet
Subscriber.Address.Zip number Postleitzahl
Subscriber.Address.Line1 string Hauptadresszeile
Subscriber.Address.Line2 string Zusätzliche Adresszeile
Subscriber.Address.Line3 string | null Zusätzliche Adresszeile
Subscriber.Birthday string (YYYY-MM-DD) Geburtsdatum im Format YYYY-MM-DD
Beispiel einer erfolgreichen Antwort. Enthält die aktuellen Daten des Abonnenten (nach der Aktualisierung) in derselben Struktur wie in der API-Anfrage.
{
    "success": true,
    "Subscriber": {
        "Id": 23,
        "Base": {
            "Id": 13,
            "Name": "Test Users"
        },
        "IsActive": true,
        "Email": "username@example.com",
        "FirstName": "Cat",
        "LastName": "Catstone",
        "Gender": "male",
        "Phone": "+380111222333",
        "Tags": [
            "api",
            "test-user"
        ],
        "ClientUserId": "ClientUserId12345",
        "CustomField1": "CustomValue1",
        "CustomField2": "CustomValue2",
        "CustomField3": "CustomValue3",
        "Address": {
            "Country": "UA",
            "City": "Odesa",
            "State": "",
            "Zip": "65000",
            "Line1": "Very Long street",
            "Line2": "building 42",
            "Line3": ""
        },
        "Birthday": "2002-04-15"
    }
}