Partner-Ansprechpartner-API

Verwaltung der einem Partner zugeordneten Ansprechpartner — Abruf, Erstellung, Änderung und Löschung

Basis-URL

https://{tenant}.logzi.com/api/partner_user/

Jede Anfrage liefert eine JSON-Antwort zurück. Bei Erfolg ist result.code == 1, bei einem Fehler result.code == 0. Der Partner-Ansprechpartner ist eine dem Partner zugeordnete Person — Telefonnummer, E-Mail-Adresse und Anrede können ebenfalls angegeben werden.

GET /api/partner_user/get

Abruf eines einzelnen Partner-Ansprechpartners anhand von ID, E-Mail-Adresse oder Partner-ID.

Query-Parameter

ParameterTypPflichtBeschreibung
idintEindeutige Kennung des Ansprechpartners
emailstringSuche anhand der E-Mail-Adresse
partner_idintKennung des Partners — der erste Ansprechpartner wird zurückgegeben

Beispielanfrage

GET /api/partner_user/get?id=7
X-API-KEY: {ihr_api_schluessel}
GET /api/partner_user/list

Abruf einer paginierbaren Liste von Partner-Ansprechpartnern mit Filtermöglichkeiten.

Query-Parameter

ParameterTypPflichtBeschreibung
list_offsetintPaginierungs-Offset (Standard: 0)
partner_idintFilter nach Partner-Kennung
list_condition[partner_id]intFilter nach Partner-Kennung (im Bedingungsobjekt)
list_condition[name]stringFilter nach Name (LIKE)
list_condition[email]stringFilter nach E-Mail-Adresse (LIKE)
list_condition[telephone]stringFilter nach Telefonnummer (nur anhand der Ziffern)
list_condition[fax]stringFilter nach Faxnummer (LIKE)
list_condition[invocation]stringFilter nach Anrede (LIKE)

Beispielanfrage

GET /api/partner_user/list?partner_id=42&list_offset=0
X-API-KEY: {ihr_api_schluessel}
POST /api/partner_user/save

Erstellen oder Ändern eines Partner-Ansprechpartners. Für einen neuen Ansprechpartner data[id] = 0.

POST-Felder — data-Objekt

FeldTypPflichtBeschreibung
idint0 = neuer Ansprechpartner, >0 = Änderung
partner_idintKennung des Partners (bei neuem Ansprechpartner erforderlich)
namestringName des Ansprechpartners
emailstringE-Mail-Adresse
telephonestringTelefonnummer
faxstringFaxnummer
invocationstringAnrede (z. B. "Sehr geehrter Herr")
partner_user_status_idintKennung des Ansprechpartner-Status
outer_resource_idstringKennung im externen System

Beispielanfrage

POST /api/partner_user/save
X-API-KEY: {ihr_api_schluessel}
Content-Type: application/json

{
  "data": {
    "id": 0,
    "partner_id": 42,
    "name": "Kovács Béla",
    "email": "kovacs.bela@minta.hu",
    "telephone": "+36301234567",
    "invocation": "Tisztelt Kovács Úr!"
  }
}
POST /api/partner_user/delete

Löschen eines Partner-Ansprechpartners anhand der ID.

POST-Felder — data-Objekt

FeldTypPflichtBeschreibung
idintKennung des zu löschenden Ansprechpartners

Beispielanfrage

POST /api/partner_user/delete
X-API-KEY: {ihr_api_schluessel}
Content-Type: application/json

{ "data": { "id": 7 } }

Nimm Kontakt mit uns auf

Interessierst du dich für unsere Software? Schreib uns einfach!

Brauchst du Hilfe?

Wenn du keine Antwort findest und Unterstützung brauchst

Jetzt registrieren,
später bezahlen!

Teste es 3 Tage kostenlos, ohne Risiko und Verpflichtungen!