WAPI - Globale Mitglieder

Dieser Artikel enthält Informationen zu den folgenden Anträgen:

• wg-mitglieder-erstellen
• wg-members-show
• wg-members-delete

---

wg-mitglieder-erstellen

Verwenden Sie die wgp-members-create um eine Einladung an eine neue Person zu senden Mitglied.

Parameter

• email = E-Mail-Adresse des neuen Mitglieds oder Login des bestehenden WEDOS-Kontos - erforderlich
• policies = Array von Berechtigungen für alle Domänen (*) oder bestimmte Domänen; Werte sind 1 für ReadOnly, 0 für vollen Zugriff. Siehe Vorlage für Details.

Rückgabewerte

• 1000 = OK
• 2223 = ungültiges E-Mail-Format oder Adresse existiert nicht
• 2274 = interner Fehler - fehlende user_id
• 2400 = interner Fehler - unbekannter Antwortcode
• 2419 = Einladung nicht gefunden
• 2420 = ungültiges Richtlinienfeld
• 4000 = Systemfehler

Antwortdaten

• email = E-Mail, die die Einladung erhält
• url = URL-Adresse der Einladungsbestätigung
• policies_count = Anzahl der aktivierten Policen (ungültige Domains werden vom System automatisch aussortiert)

Schablonen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "wg-members-create",
    "clTRID": "your ID",
    "data": {
      "email": "new member email (WEDOS account login)",
      "policies": {
        "domain01.tld": "0|1",
        "domain02.tld": "0|1",
        "*": "0|1"
      }
    }
  }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "wg-members-create",
    "data": {
      "email": "new member email (WEDOS account login)",
      "url": "invitation url",
      "policies_count": "number of successfully activated policies"
    }
  }
}

---

wg-members-show

Verwenden Sie die wgp-members-show Die Rückkehr ist ein Mitglied Einladung URL.

Parameter

• email = E-Mail-Adresse des Mitglieds oder bestehendes WEDOS-Konto-Login - erforderlich

Rückgabewerte

• 1000 = OK
• 2223 = ungültiges E-Mail-Format oder Adresse existiert nicht
• 2274 = interner Fehler - fehlende user_id
• 2400 = interner Fehler - unbekannter Antwortcode
• 2419 = Einladung nicht gefunden
• 4000 = Systemfehler

Antwortdaten

• email = E-Mail, die die Einladung erhält
• url = URL-Adresse der Einladungsbestätigung
• policies_count = Anzahl der aktivierten Policen (ungültige Domains werden vom System automatisch aussortiert)

Schablonen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "wg-members-show",
    "clTRID": "your ID",
    "data": {
      "email": "new member email (WEDOS account login)"
    }
  }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "wg-members-show",
    "data": {
      "email": "new member email (WEDOS account login)",
      "url": "invitation url",
      "policies_count": "number of successfully activated policies"
    }
  }
}

---

wg-members-delete

Verwenden Sie die wgp-members-delete zum Entfernen einer bestehenden Mitglied und widerrufen ihre Berechtigungen.

Parameter

• email = E-Mail-Adresse des Mitglieds oder bestehendes WEDOS-Konto-Login - erforderlich

Rückgabewerte

• 1000 = OK
• 2223 = ungültiges E-Mail-Format oder Adresse existiert nicht
• 2274 = interner Fehler - fehlende user_id
• 2400 = interner Fehler - unbekannter Antwortcode
• 2419 = Einladung nicht gefunden
• 4000 = Systemfehler

Antwortdaten

• email = Anmelde-E-Mail des Mitglieds

Schablonen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "wg-members-delete",
    "clTRID": "your ID",
    "data": {
      "email": "member email (WEDOS account login)"
    }
  }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "wg-members-delete",
    "data": {
      "email": "member email (WEDOS account login)"
    }
  }
}