Tài liệu hướng dẫn sử dụng API Vietnam AI Hackathon

2377

Tại cuộc thi Vietnam AI Hackathon, Tập đoàn FPT mở rất nhiều dữ liệu và API giá trị để giúp các đội thi phát triển ý tưởng, tạo ra những ứng dụng áp dụng Trí tuệ nhân tạo giúp người dùng có những trải nghiệm không giới hạn. Dưới đây là tài liệu chi tiết của các API.

SECURITY, COMMERCE & INFRASTRUCTURE

LANGUAGE & SPEECH

VISION & DATA INSIGHTS

DATA

NHÓM API SẢN PHẨM CỦA SENDO

Sendo.vn cung cấp 3 APIs: Lấy danh sách sản phẩm theo ngành hàng; Tìm kiếm sản phẩm trên Sendo.vn; Lấy thông tin chi tiết sản phẩm trên Sendo.vn (Link chi tiết: Download tại đây)

Một số bài toán gợi ý từ Sendo.vn, để các đội có thể tham khảo:

  • Trải nghiệm mua hàng thông minh: 
    • Ví dụ Dùng Chatbot kết hợp với APIs của Sendo.vn, để giúp người dùng browse / tìm kiếm sản phẩm ngay trong giao diện chat
  • Phát hiện hàng giả / hàng nhái
    • Ví dụ: Dùng APIs để crawl sản phẩm trên Sendo.vn
    • Sau đó, khi người dùng input một tên thương hiệu như “adidas”, chương trình sẽ trả về tất cả những sản phẩm được phát hiện là hàng giả / hàng nhái của thương hiệu đó
    • Các thông tin chương trình có thể sử dụng để phát hiện hàng giả / hàng nhái:
      • Ứng dụng các thuật toán nhận dạng hình ảnh để tìm xem trong hình ảnh của sản phẩm có chứa logo của Adidas hay không
      • Giá của sản phẩm: Các sản phẩm hàng giả / hàng nhái thường có giá thấp hơn (nhiều) so với các sản phẩm chính hãng
  1. Lấy danh sách sản phẩm theo ngành hàng
Parameter nameDescription
Category_level_1Category alias level 1
Category_level_2Category alias level 2
Category_level_3Category alias level 3
pThứ tự trang. Ví dụ: p=1, p=2, ..
qKeyword để tìm kiếm trong ngành hàng
  • Response Values:
Key nameDescription
category_level1_idID của category level 1
category_level1_nameTên của category level 1
category_level2_idID của category level 2
category_level2_nameTên của category level 2
category_level3_idID của category level 3
category_level3_nameTên của category level 3
display_styleCách hiển thị sản phẩm.

– List: hàng dọc

– Grid: dạng lưới

total_pageTổng số trang tồn tại sản phẩm
total_countTổng số sản phẩm thỏa điều kiện hiển thị
keywordKeyword được tìm kiếm theo ngành hàng
product_idID của sản phẩm
nameTên sản phẩm
admin_idID của shop
brand_idID của thương hiệu
app_dis_count_percentTỉ lệ giảm giá khi mua trên app
is_adsSản phẩm đăng ký quảng cáo
is_eventSản phẩm đăng ký tham gia event
order_count_dd_1000_codTổng số đơn hàng đặt mua sản phẩm trong 3 tháng
cat_pathUrl sản phẩm
category_idCategory ID của sản phẩm
counter_viewSố lượt xem sản phẩm
counter_likeSố lượt yêu thích sản phẩm
deposit_amountSố tiền của thanh toán trước khi đặt hàng
free_shippingMiễn phí vận chuyển
img_urlHình ảnh sản phẩm
img_url_mobHình ảnh sản phẩm
is_certifiedSản phẩm được được duyệt
is_promotionSản phẩm có khuyến mãi
priceGiá bán sản phẩm
promotion_percentTỉ lệ % giảm giá trên sản phẩm
final_promotion_percentTổng tỉ lệ % giảm giá trên sản phẩm
shop_idID của shop
shop_nameTên shop
special_priceGiá khuyến mãi
loyalty_price
final_priceGiá bán sau khuyến mãi
percent_starTỉ lệ đánh giá sản phẩm
is_product_installmentSản phẩm cho trả góp
url_icon_eventUrl icon hiển thị cho event

2. Tìm kiếm sản phẩm trên Sendo.vn

Parameter nameDescription
pThứ tự trang. Ví dụ: p=1, p=2, ..
qKeyword để dùng tìm kiếm
  • Response Values
Key nameDescription
total_pageTổng số trang tồn tại sản phẩm
total_countTổng số sản phẩm thỏa điều kiện hiển thị
keywordKeyword được tìm kiếm theo ngành hàng
product_idID của sản phẩm
nameTên sản phẩm
admin_idID của shop
brand_idID của thương hiệu
app_dis_count_percentTỉ lệ giảm giá khi mua trên app
is_adsSản phẩm đăng ký quảng cáo
is_eventSản phẩm đăng ký tham gia event
order_count_dd_1000_codTổng số đơn hàng đặt mua sản phẩm trong 3 tháng
cat_pathUrl sản phẩm
category_idCategory ID của sản phẩm
counter_viewSố lượt xem sản phẩm
counter_likeSố lượt yêu thích sản phẩm
deposit_amountSố tiền của thanh toán trước khi đặt hàng
free_shippingMiễn phí vận chuyển
img_urlHình ảnh sản phẩm
img_url_mobHình ảnh sản phẩm
is_certifiedSản phẩm được được duyệt
is_promotionSản phẩm có khuyến mãi
priceGiá bán sản phẩm
promotion_percentTỉ lệ % giảm giá trên sản phẩm
final_promotion_percentTổng tỉ lệ % giảm giá trên sản phẩm
shop_idID của shop
shop_nameTên shop
special_priceGiá khuyến mãi
loyalty_price
final_priceGiá bán sau khuyến mãi
percent_starTỉ lệ đánh giá sản phẩm
is_product_installmentSản phẩm cho trả góp
url_icon_eventUrl icon hiển thị cho event

3. Lấy thông tin chi tiết sản phẩm trên Sendo.vn

Parameter nameDescription
product_idID của sản phẩm
  • Response Values
Key nameDescription
idID của sản phẩm
nameTên sản phẩm
priceGiá bán sản phẩm
admin_idID của shop
special_priceGiá khuyến mãi
imagesDanh sách hình ảnh sản phẩm
final_priceGiá bán cuối cùng sau khuyến mãi
deposit_amountSố tiền đặt cọc
promotion_percentTỉ lệ % giảm giá sản phẩm
app_dis_count_percentTỉ lệ % giảm giá khi mua hàng bằng mobile apps
final_promotion_percentTổng tỉ lệ % được giảm giá
is_promotionSản phẩm có khuyến mãi

1: Có

0: Không

descriptionMô tả chi tiết sản phẩm
category_idID danh mục của sản phẩm
Vd: 1/2/8/664/667
Bỏ 1/2/ đi vì đây là ID default của root8: level 1664: level 2667: level 3
created_atThời gian đăng bán (Unix timestamp)
cat_pathUrl của sản phẩm
total_commentTổng số bình luận của sản phẩm
total_rating_imageTổng số đánh giá có hình ảnh
counter_likeTổng số lượt yêu thích sản phẩm
order_countTổng số đơn hàng đã đặt mua sản phẩm
url_keyURL key
skuSKU của sản phẩm
sku_userSKU user shop tự định nghĩa
attributeThông số thuộc tính sản phẩm
rating_infoThông tin đánh giá sản phẩm
product_relatedsDanh sách ID các sản phẩm liên quan
promotion_start_dateNgày bắt đầu chương trình khuyến mãi (Unix Timestamp)
shop_free_shippingShop hỗ trợ miễn phí vận chuyển cho sản phẩm
short_descriptionMô tả ngắn về sản phẩm
stock_statusTrạng thái còn hàng

1: Còn hàng

0: Hết hàng

status_textText hiển thị trạng thái sản phẩm
shipping_supportHỗ trợ phí vận chuyển

{

order_amount: 200000, // Giá trị đơn hàng tối thiểu

seller_support_fee: 20000, // Giá trị mức phí shop hỗ trợ vận chuyển

position: 1 // Thứ tự hiển thị

}

brand_idID của thương hiệu
brand_nameTên thương hiệu
categoriesCategory path của sản phẩm
shop_infoThông tin chủ shop
status_quantitySố lượng tồn kho


NHÓM API SẢN PHẨM CỦA FPT TRADING

  1. Website so sánh giá bán lẻ sản phẩm FTG
  • Gợi ý ứng dụng:
    • Xây dựng ứng dụng (web/app) hiển thị thông tin các sản phẩm FTG bán theo danh mục, hiển thị giá bán lẻ tham khảo của ít nhất 10 website bán lẻ lớn tại Việt Nam (hiển thị theo giá tăng dần)
    • Website có tình năng filter sản phẩm theo cấu hình chi tiết (ví dụ: RAM, CPU, HDD,…)
  • API:
  1. Ứng dụng Mobile Xác nhận giao hàng

GENDER RECOGNITION

  • Mô tảXác định hoặc xác minh một người từ một hình ảnh kỹ thuật số. Một trong những phương pháp để thực hiện nhận biết là so sánh một số đặc điểm nhất định trên khuôn mặt từ hình ảnh và cơ sở dữ liệu về khuôn mặt. Sử dụng các thuật toán nhận diện khuôn mặt để xác định các đặc điểm bằng cách tách các điểm mốc, hoặc các đặc điểm từ một hình ảnh khuôn mặt của đối tượng cần xác định.
  • Gợi ý ứng dụng: Công nghệ này thường được sử dụng trong các hệ thống an ninh và có thể được so sánh với các phương pháp sinh trắc học khác như hệ thống nhận dạng vân tay hoặc mống mắt.
  • Demo: https://openfsoft-beta.fsoft.com.vn/livedemo/5
  • Request URL: https://openfsoft-beta.fsoft.com.vn/apigateway/api/face/file
  • Method: POST
  • Parameters (form-data):
KeyValue
filehuman image file
  • Response Body:[{“fx”:192,”fy”:35,”fh”:99,”fw”:99,”eyes”:[{“ex”:19,”ey”:30,”ew”:23,”eh”:23},{“ex”:52,”ey”:30,”ew”:24,”eh”:24}],”gender”:”male”}]

LPR – HỆ THỐNG ĐỌC BIỂN SỐ XE

  • Mô tả: Đầu vào sẽ là ảnh xe ô tô có kèm biển số xe, đầu ra là biển số xe của xe đó theo dạng text.
  • Gợi ý ứng dụng: Đọc biển số xe
  • Địa chi truy cập: https://openfsoft-beta.fsoft.com.vn/livedemo/29
  • Request URL: https://openfsoft-beta.fsoft.com.vn/apigateway/api/lprjp
  • Method: POST
  • Parameters (form-data):
KeyValue
fileJapanese license plate image file
  • Response Body: {“issuingOffice”:”長野”,”vehicleClass”:”1″,”hiragana”:”せ”,”lowerNumber”:”7809″}

FACIAL RECOGNITION – NHẬN DIỆN KHUÔN MẶT

KeyValue
urla image url
  • Response Body: [[{“box”: {“bottom”: 166,”height”: 130,”left”: 294,”right”: 423,”top”:37,”width”: 130},”name”: “Barack Obama”}]]

OBJECT RECOGNITION – NHẬN DIỆN ĐỐI TƯỢNG

KeyValue
imagefilean object image file
  • Response Body:[[{“confidence”: 0.96653318, “bbox”: [254, 35, 441, 231], “label”: “cat”}], [{“confidence”: 0.96318173, “bbox”: [37, 11, 251, 231], “label”: “dog”}]]

EMOTION ANALYSIS – PHÂN TÍCH CẢM XÚC KHI GỌI VIDEO

  • Mô tả: Phân tích cảm xúc nhằm xác định thái độ của người nói, nhà văn hoặc đối tượng khác liên quan đến một số chủ đề hoặc ngữ cảnh tổng thể hoặc phản ứng về mặt cảm xúc đối với một tài liệu, sự tương tác hoặc một sự kiện nào đó. Thái độ có thể là sự đánh giá, trạng thái tình cảm (của tác giả hoặc diễn giả), hoặc sự thể hiện cảm xúc dự định trước (hiệu ứng cảm xúc đã định trước của tác giả hoặc người đang cùng nói chuyện).
  • Gợi ý ứng dụng: Bản demo này là một ứng dụng có khả năng tìm và theo dõi khuôn mặt trong bất kỳ bức ảnh hoặc hình ảnh nào, sau đó cố gắng xác định những cảm xúc tích cực, tiêu cực và trung lập của khuôn mặt qua thị giác máy tính và học máy.
  • Địa chỉ truy cập: https://openfsoft-beta.fsoft.com.vn/livedemo/13
  • Request URL: https://openfsoft-beta.fsoft.com.vn/apigateway/api/emotion/upload_json
  • Method: POST
  • Parameters (form-data):
KeyValue
imagefilea face image file
  • Response Body:[{“faceRectangle”: {“width”: 129,”top”: 109,”left”: 251,”height”: 129},”scores”: {“fearful”: 0.00019812668324448168,”angry”: 0.0005837445496581495,”sad”: 0.00004130572415306233,”neutral”: 0.0003822192666120827,”disgusted”: 0.000013609809684567153,”surprised”: 0.0005325537640601397,”happy”: 0.9982484579086304}}]

ENTITY EXTRACTION – XỬ LÝ NGÔN NGỮ TỰ NHIÊN, CHATBOT

  • Tổng quan: Đây là một triển khai Java của một bộ Named-entity recognizer (NER). NER đặt tên các chuỗi từ trong một văn bản là tên của sự vật, chẳng hạn như tên người và tên công ty hoặc vị trí. Trong bản demo bao gồm các bộ nhận dạng thực thể có tên cho tiếng Anh, đặc biệt là cho 3 lớp (PERSON, ORGANIZATION, và LOCATION).
  • Ứng dụng: Named-entity recognizer (NER) (còn gọi là nhận diện đối tượng, tập hợp thực thể và khai thác thực thể) là một phần của việc khai thác thông tin tìm kiếm để định vị và phân loại các thực thể được đặt tên trong văn bản thành các loại được xác định trước như tên người, vị trí, biểu hiện về thời gian, số lượng, giá trị tiền tệ, tỷ lệ phần trăm, v.v …
  • Lợi ích & Giá trị: Phần mềm này cung cấp sự thi hành đồng bộ các mô hình chuỗi tuyến tính các Trường điều kiện ngẫu nhiên (Conditional Random Field – CRF) (theo thứ tự ngẫu nhiên). Nghĩa là, bằng cách đào tạo mô hình của riêng bạn trên dữ liệu đã được dán nhãn, bạn thực sự có thể sử dụng mã này để xây dựng các mô hình trình tự cho NER hoặc thục hiện bất kỳ công việc nào khác.
  • Trường hợp sử dụng
    • Xử lý ngôn ngữ tự nhiên
    • Chatbot
  • Request URL: https://openfsoft-beta.fsoft.com.vn/apigateway/api/ner/c?s={query_string}
  • Method: GET
  • Parameters:
    • Parameter: s
    • Value: {query string – a sentence}

Example: I am Tom

  • Response Body:

PARSING, POS TAGGING TOKENS – XỬ LÝ NGÔN NGỮ TỰ NHIÊN

Request URL: https://openfsoft-beta.fsoft.com.vn/apigateway/api/pos/json?s={query_string}

Method: GET

Parameters:

Parameter: s

Value: {query string – a sentence}

Example: I am an IT guy.

Response Body:

BÌNH LUẬN

Please enter your comment!
Please enter your name here