# API Login

Đặc tả

* URL: \<API\_GATEWAY>/api/partner/login
* Method: POST
* Mô tả: Khởi tạo phiên làm việc mới cho người
* Yêu cầu bảo mật: [Mã hóa dữ liệu và kèm theo chữ ký điện tử](https://gotadi.gitbook.io/technical-documentation/~/changes/hxSZJK0E5x4hAwJJ8axI/vietnamese/yeu-cau-bao-mat)

#### Request <a href="#request" id="request"></a>

<details>

<summary>Model</summary>

* key (string, required),

  Key giải mã dữ liệu (đã được mã hóa). Cách thành lập tham khảo mục: [Mã hóa dữ liệu truyền và xác thực chữ ký điện tử](https://developer.gotadi.com/dev-guide/b2b2c-partner-webview/api-security/#ma-hoa-du-lieu-truyen-va-xac-thuc-chu-ky-ien-tu)
* data (string, required),

  Dữ liệu kèm theo chữ ký điện tử (đã được mã hóa). Cách giải mã tham khảo mục: [Mã hóa dữ liệu truyền và xác thực chữ ký điện tử](https://developer.gotadi.com/dev-guide/b2b2c-partner-webview/api-security/#ma-hoa-du-lieu-truyen-va-xac-thuc-chu-ky-ien-tu)

  *Signature data schema:*

  ```
  <access_code>|<user_id>|<layout>|<product>
  ```

  *Original data schema:*

  ```
  <access_code>|<user_id>|<layout>|<product>|<signature>
  ```

  * access\_code (String, required)

    Access code do Gotadi cung cấp cho Đối tác.
  * user\_id (String, required)

    Mã định danh người dùng trên hệ thống của Đối tác.
  * layout (String, optional)

    Có giá trị là `dual` hoặc `single` tương ứng với 2 loại layout Gotadi cung cấp cho đối tác.
  * product (String, required)

    Có giá trị là `flight` hoặc `hotel`. Tương ứng với 2 sản phẩm Gotadi cung cấp cho đối tác.

    Khi layout là `single`: Dùng để chọn dịch vụ hiển thị trên webview.

    Khi layout là `dual`: Dùng để focus dịch vụ hiển thị trên webview.

</details>

#### Example

{% code fullWidth="false" %}

```json
{
    "data": "...",
    "key": "..."
}
```

{% endcode %}

#### Response <a href="#response" id="response"></a>

<details>

<summary>Model</summary>

* **key (String, required)**

  Key giải mã dữ liệu (đã được mã hóa). Cách giải mã tham khảo mục: [Mã hóa dữ liệu truyền và xác thực chữ ký điện tử](https://developer.gotadi.com/dev-guide/b2b2c-partner-webview/api-security/#ma-hoa-du-lieu-truyen-va-xac-thuc-chu-ky-ien-tu)
* **data (String, required)**

  Dữ liệu kèm theo chữ ký điện tử (đã được mã hóa). Cách giải mã tham khảo mục: [Mã hóa dữ liệu truyền và xác thực chữ ký điện tử](https://developer.gotadi.com/dev-guide/b2b2c-partner-webview/api-security/#ma-hoa-du-lieu-truyen-va-xac-thuc-chu-ky-ien-tu)

  *Signature data schema:*

  ```
  <access_code>|<error_code>|<redirect_url>
  ```

  *Original data schema:*

  ```
  <access_code>|<error_code>|<redirect_url>|<signature>
  ```

  * access\_code (String, required)

    Access code do Gotadi cung cấp cho Đối tác.
  * error\_code (String, required) [Mã lỗi](https://gotadi.gitbook.io/technical-documentation/~/changes/hxSZJK0E5x4hAwJJ8axI/vietnamese/tich-hop-doi-tac-b2b2c/phuong-thuc-webview#ma-loi)
  * redirect\_url (String, optional)

    Đường dẫn tới Webview Gotadi có kèm theo jwtToken.

    ```
    https://<gotadi_webview_url>?access_token=<jwtToken>
    ```

</details>

#### Example

```json
{
    "data": "...",
    "key": "..."
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.gotadi.com/vietnamese/doi-tac-b2b2c/phuong-thuc-webview/api-login.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.