Nhanh.vn Open API
Trang chủHướng dẫn sử dụngApps
v2
v2
  • Giới thiệu
  • Change log
  • Product
    • Danh sách sản phẩm
    • Thêm sản phẩm
    • Chi tiết sản phẩm
    • Danh mục sản phẩm
    • Danh mục nội bộ
    • Quà tặng sản phẩm
    • Danh sách IMEI
    • Tra cứu IMEI bán ra theo ngày
    • Lịch sử IMEI
    • Hạn sử dụng sản phẩm
    • Thêm ảnh sản phẩm
  • Order
    • Danh sách đơn hàng
    • Thêm đơn hàng
    • Cập nhật đơn hàng
    • Gửi khiếu nại đơn hàng
    • Lịch sử đơn hàng
    • Nguồn đơn hàng
  • Shipping
    • Hãng vận chuyển
    • Thành phố, quận huyện
    • Tính phí vận chuyển
  • Bill
    • Phiếu xuất nhập kho
    • Sản phẩm xuất nhập kho
    • Sản phẩm xuất nhập kho nháp
  • Customer
    • Danh sách khách hàng
    • Thêm khách hàng
  • Website
    • Tin tức
    • Danh mục tin tức
    • Thêm subscriber
    • Thêm liên hệ
  • Supplier
    • Nhà cung cấp
  • Promotion
    • Danh sách coupon
  • Store
    • Kho hàng
    • Nhân viên
  • Accounting
    • Bút toán
    • Công nợ khách hàng
  • Zalo
    • Gửi tin Zalo ZNS
  • Ecommerce
    • Danh sách gian hàng
  • Webhooks
    • Giới thiệu
    • Đơn hàng
    • Sản phẩm
    • Tồn kho
Powered by GitBook
On this page
  • Request
  • Sample request
  • Response

Was this helpful?

  1. Product

Thêm ảnh sản phẩm

PreviousHạn sử dụng sản phẩmNextDanh sách đơn hàng

Last updated 5 months ago

Was this helpful?

  • API này dùng để thêm ảnh cho sản phẩm từ CDN khác không thuộc Nhanh.vn, thường dùng khi bạn có website riêng và có link ảnh trên website riêng, không upload ảnh lên Nhanh.vn

  • Được thêm tối đa 10 sản phẩm mỗi request, mỗi sản phẩm tối đa 20 ảnh.

  • Chú ý:

    • Nhanh.vn sẽ không tải các link ảnh này về Nhanh.vn mà dùng luôn đường dẫn link ảnh bạn bắn sang để hiển thị hoặc đồng bộ đi các chỗ khác.

    • Khi dùng tính năng đồng bộ Facebook Shop, nếu sản phẩm trên Nhanh.vn không có ảnh, nhưng có ảnh (external image) bắn từ API về, Nhanh.vn sẽ dùng external images này để bắn lên Facebook Shop. Facebook yêu cầu anh có độ phân giải tối thiếu từ 500 x 500px. Chú ý: Server xử lý ảnh này cần đảm bảo tốc độ ổn định: Tốc độ nhanh, không chặn các tool crawler của Facebook (thường là IP từ United States).

Request

  • URI: /api/product/externalimage. Xem các .

  • Các key của mảng data array dùng để tạo data json string.

  • Cho phép thêm ảnh cho nhiều sản phẩm cùng lúc

data = [
    {
        "productId": int, // ID sản phẩm trên Nhanh.vn
        "externalImages": [
            "imagePath1", // link ảnh sản phẩm
            "imagePath2", // link ảnh sản phẩm
        ]
    },
    {
        "productId": int, // ID sản phẩm trên Nhanh.vn
        "externalImages": [
            "imagePath1", // link ảnh sản phẩm
            "imagePath2", // link ảnh sản phẩm
        ]
    },
    ...
]
Key
Type
Description

productId

ID sản phẩm trên Nhanh.vn

mode

string

update (mặc định nếu không truyền giá trị) hoặc deleteall - Mode update: Nhanh sẽ check nếu trên hệ thống chưa có ảnh trong mảng thì sẽ thêm mới. Các sản đã bắn sang trước đó, mà sau đó không tồn tại ở mảng mới, sẽ bị xóa khỏi hệ thống - Mode deleteall: Xóa hết ảnh cũ của sản phẩm

externalImages

array

Link ảnh sản phẩm VD: imageLinks = [ "https://external.cdn.com/product/image1.jpg", "https://external.cdn.com/product/image2.jpg" ]

Sample request

curl --location 'https://open.nhanh.vn/api/product/externalimage' \
--form 'version="2.0"' \
--form 'appId="{{appId}}"' \
--form 'businessId="{{businessId}}"' \
--form 'accessToken="{{accessToken}}"' \
--form 'data="[{\"productId\":312311,\"externalImages\":[\"https://external.cdn.com/product/image1.jpg\",\"https://external.cdn.com/product/image2.jpg\"]},{\"productId\":312312,\"externalImages\":[\"https://external.cdn.com/product/image3.jpg\"]}]"'

Response

JSON decode the response to get the structure:

Key
Type
Description

code

int

1 = success or 0 = failed

messages

array

is an array of error messages if code = 0

data

array

Mảng ID sản phẩm trên Nhanh.vn

[
    "code" => 1, // 1 is success, 0 is error
    "messages" => [], // error messages if code is 0
    "data" => [
        // int ID sản phẩm Nhanh.vn
        "productId1",
        "productId2",
        "productId3",
        ...
    ]
]

bigint

∗^{{\color{red}*}}∗
common request params