> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Menambahkan peran ke beberapa karyawan secara massal

> Panggil API ini untuk menambahkan peran ke beberapa karyawan sekaligus di DingTalk. Peran pada grup Default seperti pemilik, supervisor, super admin, dan sub admin tidak dapat ditambahkan.

Panggil API ini untuk menambahkan peran ke beberapa karyawan secara massal. Peran pada grup "Default", termasuk Owner, Supervisor, Super Admin, dan Sub Admin, tidak dapat ditambahkan.

## Permintaan

| **Informasi dasar**         |                                                                                                            |
| --------------------------- | ---------------------------------------------------------------------------------------------------------- |
| URL HTTP                    | [https://api.dingtalk.io/topapi/role/addrolesforemps](https://api.dingtalk.io/topapi/role/addrolesforemps) |
| Metode HTTP                 | POST                                                                                                       |
| Tipe aplikasi yang didukung | appType-Aplikasi internal                                                                                  |
| Izin yang diperlukan        | permission-qyapi\_manage\_addresslist-Izin pengelolaan data Kontak                                         |

### Parameter kueri

| Nama          | Tipe   | Wajib | Contoh   | Deskripsi                                                                                                                                                                           |
| ------------- | ------ | ----- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| access\_token | String | Ya    | 6d1bxxxx | Kredensial aplikasi yang digunakan untuk memanggil API ini. Dapatkan melalui API untuk memperoleh [access\_token dari aplikasi internal](/id/open/development/obtain-orgapp-token). |

### Isi permintaan

| Nama    | Tipe   | Wajib | Contoh     | Deskripsi                                                                                                                                                                                                                                  |
| ------- | ------ | ----- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| roleIds | String | Ya    | 1507113584 | Daftar ID peran (roleId). Panggil API [Memperoleh daftar peran](/id/open/development/obtains-a-list-of-enterprise-roles) untuk mendapatkannya.  Pisahkan beberapa nilai roleId dengan koma (,). Maksimal 20 nilai diperbolehkan.           |
| userIds | String | Ya    | user1      | userId dari seorang karyawan. Panggil [Kueri pengguna berdasarkan nomor telepon](/id/open/development/query-users-by-phone-number) untuk mendapatkannya.  Pisahkan beberapa nilai userId dengan koma (,). Maksimal 20 nilai diperbolehkan. |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/role/addrolesforemps" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=8f577dxxxx76f2a3a2' \
-d 'roleIds=1507113584' \
-d 'userIds=user1'
```

Java

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/role/addrolesforemps");
OapiRoleAddrolesforempsRequest req = new OapiRoleAddrolesforempsRequest();
req.setRoleIds("1507113584,1507113589");
req.setUserIds("user1,user2");
OapiRoleAddrolesforempsResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());
```

Python

```python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import dingtalk.api

req=dingtalk.api.OapiRoleAddrolesforempsRequest("https://api.dingtalk.io/topapi/role/addrolesforemps")

req.roleIds="1507113584"
req.userIds="user1"
try:
  resp= req.getResponse(access_token)
  print(resp)
except Exception,e:
  print(e)
```

PHP

```php theme={"theme":{"light":"github-light","dark":"github-dark"}}
include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiRoleAddrolesforempsRequest;
$req->setRoleIds("1507113584");
$req->setUserIds("user1");
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/role/addrolesforemps");
```

C#

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/role/addrolesforemps");
OapiRoleAddrolesforempsRequest req = new OapiRoleAddrolesforempsRequest();
req.RoleIds = "1507113584";
req.UserIds = "user1";
OapiRoleAddrolesforempsResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama        | Tipe   | Contoh       | Deskripsi                         |
| ----------- | ------ | ------------ | --------------------------------- |
| errcode     | Number | 0            | Kode pengembalian.                |
| errmsg      | String | ok           | Deskripsi dari kode pengembalian. |
| request\_id | String | emhw6ma4xmeg | ID permintaan.                    |

### Contoh isi respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode": 0,
  "request_id": "emhw6ma4xmeg"
}
```

### Kode error

Jika terjadi error saat Anda memanggil API ini, lihat dokumen [Kode error global](/id/open/development/server-api-error-codes-1) untuk menemukan solusi berdasarkan pesan error.

| Kode error (errcode) | Pesan error (errmsg)            | Solusi                                    |
| -------------------- | ------------------------------- | ----------------------------------------- |
| 33011                | Invalid roleIds                 | Periksa apakah roleIds sudah benar.       |
| 33012                | Invalid userIds                 | Periksa apakah nilai userId sudah benar.  |
| 12012                | The organization does not exist | Periksa apakah access\_token sudah benar. |
| 1002                 | System busy                     | Coba lagi nanti.                          |