Tạo shop theo mô hình redirect

Mô hình kết nối

Kết nối tài khoản shop

Việc kết nối được thực hiện theo mô hình redirect. Đối tác cần chuẩn bị một địa chỉ url để nhận redirect sau khi shop được khởi tạo thành công:

Quá trình kết nối với shop:

  1. Gửi request đến .Shop/AuthorizeShop.

  2. Redirect đến địa chỉ url được cung cấp bởi auth_url, chờ shop xác thực tài khoản và nhận redirect từ eTelecom.

  3. Gửi lại request với shop_id nhận được.

  4. Lưu shop_idauth_token để sử dụng trong các API khác.

Cấu trúc body của request:

Tham số
Kiểu dữ liệu
Mô tả

email required

string

Địa chỉ email tài khoản shop muốn tạo

phone

required

string

Số điện thoại tài khoản shop muốn tạo

name

required

string

Tên tài khoản shop muốn tạo

redirect_url required

string

Redirect sau khi shop đăng nhập thành công

200 OK type=shop_request

Kết quả này nghĩa là shop sẽ được yêu cầu đăng nhập để xác nhận tài khoản. Kết quả trả về sẽ cung cấp một địa chỉ url bằng field auth_url để đối tác redirect shop đến và xác thực tài khoản.

Sau khi thực hiện xác thực tài khoản, eTelecom sẽ redirect về địa chỉ url đối tác cung cấp kèm với shop_id, theo cấu trúc: $REDIRECT_URL?token=<token>&shop_id=<shop_id>.

Lấy thông tin shop_key

Thông tin shop_id được trả về trong redirect_url khi đối tác tạo shop thành công ở bước kết nối tài khoản shop

Đối tác vẫn cần cung cấp redirect_url vì có thể xảy ra tình huống shop cần đăng nhập lại. Lúc này redirect_url sẽ được sử dụng để eTelecom redirect về sau khi shop đăng nhập thành công.

Cấu trúc body của request:

Tham số
Kiểu dữ liệu
Mô tả

shop_id

required

string

ID của shop

redirect_url

required

string

Redirect sau khi shop đăng nhập thành công

200 OK type=shop_key

Kết quả này nghĩa là đối tác đã có thể tạo tổng đài hoặc gửi zns với tư cách shop. Hãy lưu lại auth_token ứng với tài khoản của shop để sử dụng tiếp tục, thông tin này chính là shop_key

circle-info

Lưu ý: cần lưu ý rằng kể cả khi shop đã từng kết nối với eTelecom, nhưng shop vẫn có thể được yêu cầu đăng nhập lại. Tình huống này xảy ra khi shop đã gỡ liên kết với tài khoản của đối tác. Lúc này, response sẽ có type=shop_requestauth_url được trả về, đối tác cần redirect về địa chỉ này để shop đăng nhập lại.

Cấu trúc thuộc tính dữ liệu trả về:

Tham số
Kiểu dữ liệu
Mô tả

auth_token

string

Mã ủy quyền

auth_url

string

Đường dẫn ủy quyền

code

string

Trạng thái thành công hay thất bại

expires_in

int

Thời gian hết hạn

meta

object

Thuộc tính nếu có

msg

string

Mô tả api

Kiểm tra shop_key

Để kiểm tra shop_key nhận được là đúng, đối tác có thể gửi request đến:

CurrentShop

post
Body
objectOptional
Responses
chevron-right
200

A successful response

application/json
idstring · int64Optional
image_urlstringOptional
namestringOptional
typestring · enumOptionalPossible values:
websitestringOptional
post
$BASE_URL.Shop/CurrentShop
200

A successful response

Request:

Response:

Cấu trúc thuộc tính dữ liệu trả về:

Tham số
Kiểu dữ liệu
Mô tả

id

string

ID của tài khoản

name

string

Tên tài khoản

type

string

Loại tài khoản: Partner Shop

Last updated