13. Tạo tài khoản

Tạo tài khoản

Đường dẫn

POST /services/shops/add

HTTP

POST https://services.giaohangtietkiem.vn/services/shops/add HTTP/1.1
Token: APITokenSample-ca441e70288cB0515F310742
Host: services.giaohangtietkiem.vn
Content-length: 351
Content-Type: application/x-www-form-urlencoded

name=shop+test&first_address=ng%C3%B5+2%2C+Phan+B%C3%A1+V%C3%A0nh%2C+C%E1%BA%A7u+Di%E1%BB%85n&province=H%C3%A0+N%E1%BB%99i&district=B%E1%BA%AFc+T%E1%BB%AB+Li%C3%AAm&tel=01234555666&email=shoptest%40email.com

CURL

curl -X POST -H "Token: APITokenSample-ca441e70288cB0515F310742" \
-H "Content-Type: application/json;" \
-d '{"name":"shop test","first_address":"ngõ 2, Phan Bá Vành, Cầu Diễn","province":"Hà Nội","district":"Bắc Từ Liêm","tel":"01234555666","email":"shoptest@email.com"}' \
"https://services.giaohangtietkiem.vn/services/shops/add"

PHP

<?php
$order = '
{
    "name": "shop test",
    "first_address": "ngõ 2, Phan Bá Vành, Cầu Diễn",
    "province": "Hà Nội",
    "district": "Bắc Từ Liêm",
    "tel": "01234555666",
    "email": "shoptest@email.com"
}';

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://services.giaohangtietkiem.vn/services/shops/add",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $order,
    CURLOPT_HTTPHEADER => array(
        "Content-Type: application/json",
        "Content-Length: " . strlen($order),
        "Token: APITokenSample-ca441e70288cB0515F310742",
    ),
));

$response = curl_exec($curl);
curl_close($curl);

echo 'Response: ' . $response;
?>

Mô tả tham số

Tham số	Bắt buộc	Mô tả
name	yes	Tên hiển thị của tài khoản
first_address	yes	Địa chỉ chi tiết của tài khoản (số nhà, ngõ, đường, phường,…)
province	yes	Tên tỉnh/thành phố, ví dụ: Hà Nội, Thái Bình,
district	yes	Tên huyện hoặc thành phố trực thuộc tỉnh, ví dụ: Cầu Giấy, Tp Thái Bình
tel	yes	số điện thoại liên lạc của tài khoản
email	yes	email của tài khoản

Lưu ý

info

Lưu ý: Tài khoản được tạo qua API, hoàn toàn có thể login theo email và đăng đơn trên hệ thống GHTK như các tài khoản bình thường khác

info

Lưu ý: Nếu khách hàng của shop B2C đã có sẵn tài khoản trên GHTK, thì có thể lấy thông tin token trong mục ‘Sửa thông tin cửa hàng’. Không nhất thiết phải tạo tài khoản mới qua API

Kết quả trả về

Khi tạo tài khoản thành công:

Tham số	Bắt buộc	Mô tả
data.code	yes	Mã tài khoản trên hệ thống GHTK
data.token	yes	Token của tài khoản

{
    "success": true,
    "message": "Thành công",
    "data": {
        "code": "S55163",
        "token": "93A7392A44c99e7Ca395eef1321D03731B844111"
    }
}

Trường hợp email hoặc số điện thoại đã được sử dụng cho tài khoản khác

{
    "success": false,
    "message": "Email shop này đã tồn tại",
    "data": null
}

Trường hợp tài khoản B2C không có quyền tạo tài khoản mới

{
    "success": false,
    "message": "Tài khoản của bạn không có quyền tạo tài khoản mới trên GHTK",
    "data": null
}