Felhasználók végpontjai

Ezekkel a végpontokkal a vezérlőpultból kezelheted a gyermekwebhelyek felhasználóit. A pontos kérés- és válaszszerkezetet a Postman-gyűjtemény tartalmazza.

Az {id_or_domain} jelölés a webhely számazonosítóját vagy a domainjét fogadja el.

Végpontok

Metódus	Útvonal	Mire jó	Fő paraméterek
GET	/users	Felhasználók listázása a kiválasztott webhelyeken	clients, groups, websites, search, roles
POST	/users/create	Felhasználó(k) létrehozása a kiválasztott webhelyeken	username, email, opcionálisan password, role, first_name, last_name, user_url, send_password, valamint a webhelyszűrők
PUT, PATCH	/users/{id_or_domain}/{user_id}/edit	Felhasználó szerkesztése egy webhelyen	id_or_domain, user_id, a szerkeszthető profilmezők
DELETE	/users/{id_or_domain}/{user_id}/delete	Felhasználó törlése egy webhelyen	id_or_domain, user_id
PUT, PATCH	/users/update-admin-password	Az adminisztrátori jelszó frissítése a kiválasztott webhelyeken	password, valamint a clients, groups, websites szűrők
POST	/users/import	Felhasználók importálása CSV-fájlból	csv_file (többrészes feltöltés), opcionálisan has_header

CSV-import formátuma

A /users/import olyan CSV-fájlt vár, amelyben minden sor 10 oszlopot tartalmaz, ebben a sorrendben:

1. username: a felhasználónév
2. email: az e-mail-cím
3. first_name: a keresztnév
4. last_name: a vezetéknév
5. user_url: a weboldal címe
6. password: a jelszó
7. send_password: true vagy false, küldjön-e jelszót e-mailben
8. role: a szerepkör (administrator, subscriber, editor, author, contributor)
9. select_sites: a webhelyek címei, pontosvesszővel elválasztva
10. select_groups: a csoportok (címkék) nevei, pontosvesszővel elválasztva

Ha a has_header értéke true (ez az alapérték), az első sort a rendszer kihagyja.

Példák

Felhasználó létrehozása a kiválasztott webhelyeken

curl -X POST \
  -H "Authorization: Bearer API_KULCS" \
  -H "Content-Type: application/json" \
  -d '{
    "username":"szerkeszto01",
    "email":"[email protected]",
    "role":"editor",
    "send_password":true,
    "websites":"12,19"
  }' \
  "https://a-te-vezerlopultod.hu/wp-json/mainwp/v2/users/create"

{
  "success": 1,
  "message": "Users created successfully."
}

Adminisztrátori jelszó frissítése a kiválasztott webhelyeken

curl -X PUT \
  -H "Authorization: Bearer API_KULCS" \
  -H "Content-Type: application/json" \
  -d '{
    "password":"Eros-Jelszo-Minta-2026",
    "groups":"eles"
  }' \
  "https://a-te-vezerlopultod.hu/wp-json/mainwp/v2/users/update-admin-password"

{
  "success": 1,
  "message": "Administrator passwords updated successfully."
}

Felhasználók importálása CSV-fájlból

curl -X POST \
  -H "Authorization: Bearer API_KULCS" \
  -F "[email protected]" \
  -F "has_header=true" \
  "https://a-te-vezerlopultod.hu/wp-json/mainwp/v2/users/import"

A válasz megadja az összes, a sikeres és a sikertelen sorok számát, a hibás sorokat pedig a sor számával és a hiba okával együtt:

{
  "total": 15,
  "success_count": 14,
  "failed_count": 1,
  "failed_users": [
    {
      "line_number": 8,
      "error": "Invalid email format."
    }
  ]
}

A felhasználókezelés felületéről a Felhasználók kezelése és az Adminisztrátori jelszavak fejezetben olvashatsz.

Kapcsolódó fejezetek

• REST API áttekintés
• Beállítások végpontjai
• Webhelyek végpontjai