> For the complete documentation index, see [llms.txt](https://onestore-dev.gitbook.io/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onestore-dev.gitbook.io/dev/tools/webshop/app-links.md).

# 사용자 정보 연동

인게임에서 ONEshop으로 이동하는 URL에 사용자의 `게임 ID(uid)`, `서버 ID(sid)`, `커스텀 필드(customFields)`를 포함하면, 사용자가 ONEshop에 진입할 때 해당 정보가 구매창에 자동으로 입력되어 별도 입력 없이 바로 구매할 수 있습니다.

{% hint style="info" %}

* 각 파라미터는 `ONEconsole > Webshop > 개발자 > 플레이어 식별 필드`에서 설정한 식별 필드에 입력됩니다. 자세한 내용은 플레이어 식별 필드를 참고해 주세요.
* ONEshop은 전달받은 값을 구매창에 채운 뒤 주소창 URL에서 해당 파라미터를 제거합니다.
  {% endhint %}

#### URL 구조

* **Base URL :** `https://webshop.onestore.net/title/{PID}`
* **Query Params**: `uid`, `sid`, `customFields`(선택)

<table><thead><tr><th width="156.9453125">Name</th><th width="137.0130615234375">Type</th><th width="138.6536865234375">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td><code>uid</code></td><td>String</td><td>Optional</td><td><p>사용자의 게임 ID (최대 100byte)</p><ul><li>플레이어 식별 필드의 기본 식별자(UID)에 입력됩니다.</li><li>유효성 검증 요청과 PNS에는 <code>serviceUserId</code>로 전달됩니다.</li></ul></td></tr><tr><td><code>sid</code></td><td>String</td><td>Optional</td><td><p>사용자의 서버 ID (최대 100byte)</p><ul><li>플레이어 식별 필드에서 타입을 <code>서버 리스트</code>로 설정한 필드에 입력됩니다. 서버 리스트 필드의 필드 키는 <code>serviceServerId</code>로 고정됩니다.</li><li>서버 리스트 연동 API가 응답하는 <code>serverList[].serviceServerId</code> 값 중 하나를 전달해 주세요.</li></ul></td></tr><tr><td><code>customFields</code></td><td>String</td><td>Optional</td><td><p>사용자 커스텀 필드</p><ul><li><code>customFields.{필드 키}=값</code> 형식으로 필드마다 하나씩 전달합니다.</li><li><code>{필드 키}</code>는 플레이어 식별 필드에서 커스텀 필드를 추가할 때 입력한 <strong>필드 키</strong>입니다. 영문 대소문자와 숫자만 사용하며 최대 32자, 저장 후에는 변경할 수 없습니다.</li><li>유효성 검증 요청의 <code>param.serviceCustomFields</code>에 쓰이는 키와 같습니다.</li></ul></td></tr></tbody></table>

{% hint style="warning" %}
**유의사항**

`uid`, `sid`, `serviceUserId`, `serviceServerId`, `clientId`, `prodId`는 시스템 예약 키라 커스텀 필드의 필드 키로 사용할 수 없습니다.
{% endhint %}

#### Sample URL

```
https://webshop.onestore.net/title/WS00000000?uid=user1234&sid=asia01&customFields.characterId=character1234&customFields.guildId=guild1234

//WS00000000 → 타이틀 ID(PID)
//uid=user1234 → 게임 ID
//sid=asia01 → 서버 ID
//customFields.characterId=character1234 → 필드 키가 characterId인 커스텀 필드 값
//customFields.guildId=guild1234 → 필드 키가 guildId인 커스텀 필드 값
```