> ## 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 pengguna berdasarkan nomor ponsel

> Panggil API DingTalk untuk mencari userId karyawan aktif berdasarkan nomor ponsel. Pelajari parameter, contoh permintaan, dan kode error untuk integrasi Aplikasi internal.

Panggil API ini untuk mendapatkan ID pengguna karyawan aktif berdasarkan nomor ponselnya. Jika karyawan telah keluar dari organisasi, ID pengguna tidak dapat diambil berdasarkan nomor ponsel.

## Permintaan

| **Informasi dasar**          |                                                                                                                    |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| URL HTTP                     | [https://api.dingtalk.io/topapi/v2/user/getbymobile](https://api.dingtalk.io/topapi/v2/user/getbymobile)           |
| Metode HTTP                  | POST                                                                                                               |
| Jenis aplikasi yang didukung | appType-Internal app                                                                                               |
| Izin yang diperlukan         | permission-qyapi\_get\_member\_by\_mobile-Izin untuk mendapatkan informasi dasar pengguna berdasarkan nomor ponsel |

### Parameter query

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

### Isi permintaan

| Nama   | Tipe   | Wajib | Contoh             | Deskripsi              |
| ------ | ------ | ----- | ------------------ | ---------------------- |
| mobile | String | Ya    | 1\*\*\*\*\*\*\*543 | Nomor ponsel pengguna. |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/v2/user/getbymobile" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=2015ca04-c84e-4855-9e52-330b98eb35f5' \
-d 'mobile=13800138000'
```

Java

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/user/getbymobile");
OapiV2UserGetbymobileRequest req = new OapiV2UserGetbymobileRequest();
req.setMobile("1*******543");
OapiV2UserGetbymobileResponse rsp = client.execute(req, acces_token);
System.out.println(rsp.getBody());
```

Python

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

req=dingtalk.api.OapiV2UserGetbymobileRequest("https://api.dingtalk.io/topapi/v2/user/getbymobile")

req.mobile="13800138000"
req.support_exclusive_account_search=true
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 OapiV2UserGetbymobileRequest;
$req->setMobile("13800138000");
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/v2/user/getbymobile");
```

C#

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/user/getbymobile");
OapiV2UserGetbymobileRequest req = new OapiV2UserGetbymobileRequest();
req.Mobile = "13800138000";
OapiV2UserGetbymobileResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama        | Tipe   | Contoh       | Deskripsi                    |
| ----------- | ------ | ------------ | ---------------------------- |
| request\_id | String | 5w82ciuur781 | ID permintaan.               |
| errcode     | Number | 0            | Kode pengembalian.           |
| errmsg      | String | ok           | Deskripsi kode pengembalian. |
| result      | Object |              | Hasil yang dikembalikan.     |
| userid      | String | zhangsan     | ID pengguna karyawan.        |

### Contoh respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode":"0",
  "result":{
    "userid":"xiaoding"
  },
  "errmsg":"ok"
}
```

### Kode error

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

| Kode error (errcode) | Pesan error (errmsg)                      | Solusi                                                           |
| -------------------- | ----------------------------------------- | ---------------------------------------------------------------- |
| 400002               | Invalid parameter                         | Pastikan parameter diisi sesuai ketentuan dalam dokumen di atas. |
| 40104                | Invalid mobile number in the organization | Periksa apakah nomor ponsel sudah benar.                         |
| 60121                | User not found                            | Pastikan informasi diisi dengan benar.                           |
| -1                   | System busy                               | Coba lagi nanti.                                                 |