> ## 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.

# Mendapatkan tautan Kode QR untuk bergabung ke grup

> Panggil API ini untuk mendapatkan tautan undangan Kode QR bergabung ke grup di DingTalk — cocok untuk mengundang anggota dengan cepat dalam acara maupun kolaborasi proyek.

Panggil API ini untuk mendapatkan tautan undangan Kode QR bergabung ke obrolan grup. API ini berlaku untuk skenario ketika organisasi Anda perlu mengundang pengguna dengan cepat untuk bergabung ke obrolan grup, seperti kegiatan tim atau kolaborasi proyek.

## Permintaan

| **Informasi dasar**         |                                                                                                  |
| --------------------------- | ------------------------------------------------------------------------------------------------ |
| URL HTTP                    | [https://api.dingtalk.io/topapi/chat/qrcode/get](https://api.dingtalk.io/topapi/chat/qrcode/get) |
| Metode HTTP                 | POST                                                                                             |
| Tipe aplikasi yang didukung | appType-Aplikasi internal                                                                        |
| Izin yang diperlukan        | permission-qyapi\_chat\_base\_read-Izin baca untuk informasi dasar Kelola Grup DingTalk          |

### Parameter kueri

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

### Isi permintaan

| Nama   | Tipe   | Wajib | Contoh          | Deskripsi                                                                                                 |
| ------ | ------ | ----- | --------------- | --------------------------------------------------------------------------------------------------------- |
| chatid | String | Ya    | chat3234dfs423a | chatid dari obrolan grup. Panggil API untuk membuat obrolan grup guna mendapatkan nilai parameter chatid. |
| userid | String | Ya    | manager4220     | userId dari pengguna yang membagikan Kode QR.                                                             |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/chat/qrcode/get" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=a1582fxxxx790254a' \
-d 'chatid=chat3234dfs423a' \
-d 'userid=314137418341347'
```

Java

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/chat/qrcode/get");
OapiChatQrcodeGetRequest req = new OapiChatQrcodeGetRequest();
req.setChatid("chat3234dfs423a");
req.setUserid("manager4220");
OapiChatQrcodeGetResponse 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.OapiChatQrcodeGetRequest("https://api.dingtalk.io/topapi/chat/qrcode/get")

req.chatid="chat3234dfs423a"
req.userid="314137418341347"
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 OapiChatQrcodeGetRequest;
$req->setChatid("chat3234dfs423a");
$req->setUserid("314137418341347");
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/chat/qrcode/get");
```

C#

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/chat/qrcode/get");
OapiChatQrcodeGetRequest req = new OapiChatQrcodeGetRequest();
req.Chatid = "chat3234dfs423a";
req.Userid = "314137418341347";
OapiChatQrcodeGetResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama        | Tipe    | Contoh                                                         | Deskripsi                                                            |
| ----------- | ------- | -------------------------------------------------------------- | -------------------------------------------------------------------- |
| result      | String  | [https://test/action/join?1233](https://test/action/join?1233) | Tautan untuk bergabung ke obrolan grup.                              |
| success     | Boolean | true                                                           | Apakah panggilan berhasil.   - **true**: Berhasil - **false**: Gagal |
| errcode     | Number  | 0                                                              | Kode yang dikembalikan.                                              |
| errmsg      | String  | ok                                                             | Deskripsi kode yang dikembalikan.                                    |
| request\_id | String  | 2tgtcjyjhptd                                                   | ID permintaan.                                                       |

### Contoh respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode": 0,
  "errmsg": "ok",
  "result": "https://qr.dingtalk.io/action/joingroup?code=v1=&_dt_no_comment=1&origin=11",
  "success": true,
  "request_id": "4jzlii1im1ui"
}
```

### 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 (errorcode) | Pesan error (errmsg)               | Solusi                             |
| ---------------------- | ---------------------------------- | ---------------------------------- |
| 34001                  | Invalid chat ID                    | Periksa apakah chatId sudah benar. |
| 40003                  | Invalid userid                     | Periksa apakah userid sudah benar. |
| 60124                  | The user is not in this group chat | Periksa apakah userid sudah benar. |
| 400001                 | System error                       | Coba lagi nanti.                   |