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

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

• CyRadar – Dịch vụ kiểm tra độ an toàn của một trang web
• FBusInfo – Dịch vụ thông tin xe bus trực tuyến
• Traffic Situation – Tình trạng giao thông
• Nhóm API sản phẩm của Sendo.vn
• Sentiment Analysis – Tự động thống kê phản hồi người dùng
• Nhóm API sản phẩm của FPT Trading
• VNExpress Open API

LANGUAGE & SPEECH

• Speech Synthesis – Tổng hợp âm thanh từ văn bản tiếng Việt
• Vietnamese Accentizer – Thêm dấu cho văn bản Tiếng Việt
• Name to Gender
• Gender Recognition
• Entity Extraction
• Parsing, POS Tagging Tokens

VISION & DATA INSIGHTS

• ANPR – Nhận dạng biển số xe, cho biển xe Việt Nam và Nhật
• LPR – Hệ thống đọc biển số xe
• Ftsrouting – các phương thức định tuyến giao thông Việt Nam
• Facial Recognition – Nhận diện khuôn mặt từ hình ảnh
• Object Recognition – nhận diện các đối tượng khác nhau từ người, xe, thú nuôi
• Emotion Analysis – Phân tích cảm xúc khi call video

DATA

• Dữ liệu ngành hàng FPT Shop – FPT Retail trong 1 tháng
  • https://s3.amazonaws.com/openfpt/FPTShop+Log/fptshop_log_part_1
  • https://s3.amazonaws.com/openfpt/FPTShop+Log/fptshop_log_part_2
  • https://s3.amazonaws.com/openfpt/FPTShop+Log/fptshop_log_part_3
  • https://s3.amazonaws.com/openfpt/FPTShop+Log/fptshop_sample
• Dữ liệu người đọc VnExpress trong 5 ngày
  • https://s3-ap-southeast-1.amazonaws.com/fpthackathon2017/vne_sample_log
  • https://s3-ap-southeast-1.amazonaws.com/fpthackathon2017/vne_log_day_1
  • https://s3-ap-southeast-1.amazonaws.com/fpthackathon2017/vne_log_day_2
  • https://s3-ap-southeast-1.amazonaws.com/fpthackathon2017/vne_log_day_3
  • https://s3-ap-southeast-1.amazonaws.com/fpthackathon2017/vne_log_day_4
  • https://s3-ap-southeast-1.amazonaws.com/fpthackathon2017/vne_log_day_5
• Dữ liệu người dùng của Sendo.vn
  • https://s3-ap-southeast-1.amazonaws.com/fpthackathon2017/sendo_log.zip
  • https://s3-ap-southeast-1.amazonaws.com/fpthackathon2017/Sendo_Readme.txt
  • https://s3-ap-southeast-1.amazonaws.com/fpthackathon2017/sendo_sample_log

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

• Mô tả: API này sẽ trả về danh sách các sản phẩm theo 1 ngành hàng của Sendo.vn. API hiện chỉ hỗ trợ lấy danh sách các sản phẩm cấp 2 & 3
• HTTP Method: GET
• URL: https://mapi.sendo.vn/mob/product/cat/{CATEGORY_LEVEL_1}/{CATEGORY_LEVEL_2}/{CATEGORY_LEVEL_3}/?p={PAGE}
• Example: https://mapi.sendo.vn/mob/product/cat/phu-kien-cong-nghe/phu-kien-may-tinh-laptop/usb/?p=1
• Request Parametes:

• Response Values:

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

• Mô tả: API này sẽ trả về danh sách các sản phẩm theo tương ứng theo keyword được truyền vào
• HTTP Method: GET
• URL: https://mapi.sendo.vn/mob/product/search?p={PAGE}&q={KEYWORD}
• Example: https://mapi.sendo.vn/mob/product/search?p=1&q=ao+khoac
• Request Parameters

• Response Values

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

• Mô tả: API này sẽ trả về chi tiết thông tin 1 sản phẩm theo ID sản phẩm
• HTTP Method: GET
• URL: https://mapi.sendo.vn/mob/product/{PRODUCT_ID}/detail/
• Example: https://mapi.sendo.vn/mob/product/5456345/detail/
• Request Parameters

• Response Values

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:
  • Lấy danh sách chủng loại sản phẩm của FTG – [GET]: http://hackathon.ftg.vn/api/category/
    • Trả về JSON kết quả: category_id, category_name
  • Lấy danh sách sản phẩm của FTG – [GET]: http://hackathon.ftg.vn/api/product/{category_id}/{page_number}/{records_per_page}
    • Trả về JSON kết quả: product_id, item_code,item_name

2. Ứng dụng Mobile Xác nhận giao hàng

• Gợi ý ứng dụng:
  • Ứng dụng Mobile (iOS, Android) cho các nhân viên giao hàng, sau khi nhân viên nhận hóa đơn từ kho, nhân viên thực hiện giao hàng cho khách hàng.
  • Khi tới địa chỉ cần giao hàng, nhân viên sẽ thực hiện mở App Mobile, scan barcode có trên hóa đơn để lấy DO Number.
  • Tiếp tục chọn Gửi thành công / Thất bại (Có message box để nhập lý do). Tên là tên nhân viên được lưu ở bước đăng nhập.
  • App có thể nhập tay DO trong trường hợp khó scan.
• API:
  • [POST] http://hackathon.ftg.vn/api/authenticate/{user_name}/{password} : trả về mã 200 nếu login ok (demo tài khoản user/123456); Đang không dùng xác thực token cho từng request sau khi login cho đơn giản
  • [GET] http://hackathon.ftg.vn/api/delivery/list/{page_ number}/{records_per_page} : trả về danh sách đơn hàng cần cập nhật giao hàng
  • [GET] http://hackathon.ftg.vn/api/delivery/detail/{delivery_id} : lấy chi tiết sản phẩm trong đơn hàng
  • [PUT] http://hackathon.ftg.vn/api/update/<user_id>/<delivery_id> : cập nhật trạng thái đã giao hàng

• 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):

• 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”}]

• 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):

• Response Body: {“issuingOffice”:”長野”,”vehicleClass”:”1″,”hiragana”:”せ”,”lowerNumber”:”7809″}

• Mô tả: Bản demo này thể hiện khả năng xác định khuôn mặt từ một hình ảnh nhất định. Sử dụng trong các hệ thống an ninh và cũng tương đương với các công nghệ sinh trắc học khác như hệ thống nhận dạng vân tay hoặc mống mắt. Gần đây, nó cũng trở nên phổ biến như một công cụ nhận dạng và tiếp thị trong thương mại.
• Địa chỉ truy cập: https://openfsoft-beta.fsoft.com.vn/livedemo/28
• Request URL: https://openfsoft-beta.fsoft.com.vn/apigateway/api/dl_facial/url_json?url={query_string}
• Method: GET
• Parameters:

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

• Mô tả: Ứng dụng trợ lý ảo cho người khiếm thị trên mobile, kết hợp giữa các API về image recognition và API về text to speech để đem lại khả năng “seeing” cho người khiếm thị.
  • Input: hình ảnh
  • Output: danh sách vật thể có trong bức ảnh (chó, mèo, bàn, ghế…)
  • Protocol: REST
• Địa chỉ truy cập: https://openfsoft-beta.fsoft.com.vn/livedemo/4  
• Request URL: https://openfsoft-beta.fsoft.com.vn/apigateway/api/dl_obj_recognition/file_gpu
• Method: POST
• Parameters (form-data):

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

• 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):

• 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}}]

• 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:

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: