JANZZjobsAPI:
nâng cao ứng dụng của bạn với dữ liệu ngữ nghĩa về công việc và kỹ năng.

2. Xác thực Mã thông báo (Token)

Dưới đây là ví dụ về cách xác thực bằng mã thông báo:

---

$(document).ajaxSend(function(e, xhr, settings) {
//xhr.setRequestHeader(‘Authorization’, ‘ Token 94724908572904572940570492423’); // rw
xhr.setRequestHeader(‘Authorization’, ‘ Token 230948723094732047329487234’); // ro
});

---

Về cơ bản, mỗi người dùng có thể nhận được một cặp token (mã thông báo), một mã để truy cập r/w và một mã chỉ read-only
Việc thêm mã thông báo đó vào yêu cầu của người dùng sẽ cho phép họ bỏ qua quá trình đăng nhập thông thường, giống như bạn phải làm bây giờ khi tạo tài khoản của mình và đăng nhập bằng tài khoản đó

3. Khái niệm API

Danh sách khái niệm
Điểm cuối API cho phép tìm kiếm các khái niệm và hiển thị chi tiết khái niệm

Các phương pháp được cho phép
■    GET

/japi/concepts
Liệt kê các khái niệm phù hợp với tiêu chí được chỉ định bởi tham số url.

Parameters:

■    search_lang

− định dạng: ISO 369-1, mã ngôn ngữ 2 ký tự, ví dụ: de, en, fr,… Chọn ‘all’ để tìm kiếm ở tất cả các ngôn ngữ
− giá trị mặc định: ‘all’
− hiệu ứng: chỉ tìm kiếm nhãn khái niệm bằng ngôn ngữ này.

■    output_lang

− định dạng: ISO 369-1, mã ngôn ngữ 2 ký tự, ví dụ: de, en, fr,…
− giá trị mặc định: ngôn ngữ trình duyệt
− hiệu ứng: trả về nhãn ưu tiên cho kết quả bằng ngôn ngữ này nếu có.

■    country

− định dạng: mã số ISO 3166-1. Ví dụ: 756 cho Thụy Sỹ, 040 cho Áo, v.
− giá trị mặc định: 0 (không có quốc gia ưu tiên)
− hiệu ứng: nhãn có mã quốc gia tương ứng sẽ được chọn thay vì nhãn thông thường hoặc nhãn ưa thích

■    q

− định dạng: bất kỳ chuỗi nào
− giá trị mặc định: ‘*’ (tìm kiếm mọi thứ)
− hiệu ứng: thực hiện tìm kiếm các khái niệm có nhãn khớp một phần với chuỗi truy vấn này

■    branch

− định dạng: danh sách các nhánh được phân tách bằng dấu phẩy để giới hạn tìm kiếm.
− các nhánh được phép: ‘nghề nghiệp’, ‘chuyên môn’, ‘chức năng’, ‘kỹ năng’, ‘kỹ năng mềm’, ‘ngôn ngữ’, ‘ngành nghề’, ‘loại_hợp đồng’
− giá trị mặc định: không có và không có tìm kiếm nào được thực hiện. Ít nhất một nhánh phải được chỉ định.

Returns:

Danh sách các khái niệm với các thuộc tính sau:
■    id: số id của khái niệm
■    url: đường liên kết cho chế độ xem chi tiết khái niệm
■    preferred_label: nhãn ưa thích của khái niệm

/japi/concepts/{concept_id}
Trả về thông tin chi tiết về một khái niệm. concept_id phải là số nguyên tương ứng với ID nội bộ của khái niệm, được trả về trong listing call

Parameters:

■    lang

− định dạng: ISO 369-1, mã ngôn ngữ 2 ký tự, ví dụ: de, en, fr, …
− giá trị mặc định: ngôn ngữ trình duyệt
− hiệu ứng: trả về nhãn ưu tiên cho kết quả bằng ngôn ngữ này nếu có.output_langg

■    country

− định dạng: mã số ISO 3166-1. Ví dụ: 756 cho Thụy Sĩ, 040 cho Áo, v.v.
− giá trị mặc định: 0 (không có quốc gia ưu tiên)
− hiệu ứng: nhãn có mã quốc gia tương ứng sẽ được chọn thay vì nhãn thông thường hoặc nhãn ưa thích

Returns:

■    labels: danh sách tất cả các nhãn của một khái niệm bao gồm các thuộc tính sau:

− text: nội dung văn bản của nhãn
− lang: ngôn ngữ của nhãn
− tags: bất kỳ thẻ tùy chọn nào cho khái niệm đó. Thẻ có thể bao gồm:

□  e: loại trừ khỏi kết quả
□  p: sử dụng làm nhãn ưa thích
□  i: luôn bao gồm nhãn này trong các tìm kiếm bên ngoài
□  c_###: khi một quốc gia được đưa vào tìm kiếm, nhãn này có mức độ ưu tiên cao hơn nhãn “p” nếu mã quốc gia khớp
□  a: nhãn phải có sẵn ở tất cả các ngôn ngữ

---

GET /japi/concepts

HTTP 200 OK
Vary:Accept
Content-Type:text/html; charset=utf-8
Allow:GET, HEAD, OPTIONS

---

…

---