Khác biệt

Đây là những khác biệt giữa hai phiên bản của trang.

--- programming4:api [2021/03/22 14:27] – vuthao
+++ programming4:api [2023/12/19 08:14] (hiện tại) – [Lệnh gọi API rewrite (không gọi vào /api.php) lỗi 404] hoaquynhtim99
@@ Dòng 2: / Dòng 2: @@
 > Hệ thống API được đưa vào kể từ phiên bản 4.5.00
+Xem mô tả luồng truy vấn thông thường và API như ảnh bên dưới
+{{ :programming4:luong-api.jpg |}}
 ===== Dành cho nhà phát triển sử dụng API =====
 ==== Lưu ý khi sử dụng API ====
   - Nếu không bắt buộc không nên sử dụng API (Mặc định NukeViet < 4.5 không cung cấp API, bản NukeViet 4.5 trở đi sẽ không kích hoạt mặc định)
+  - Tại chức năng **Cấu hình => Cấu hình chung** cần Bật **Remote API**
+  - Quyền truy cập API tại phần **Quản trị => Quyền truy cập API** đã chọn đủ API Role có chứa API cần gọi.
   - Cấp quyền ít nhất: Một API Roles chỉ nên có các quyền ít nhất, không nên cấp tất cả các quyền. Quyền có thể được thêm vào khi cần thiết và nên được thu hồi khi không còn được sử dụng.
   - Quyền truy cập API, nên được giới hạn theo IP, Xóa Quyền truy cập API nếu không dùng nữa.
@@ Dòng 21: / Dòng 27: @@
     'apikey' => '...', // Khóa được cung cấp
     'timestamp' => '...', // Thời gian resquest sai lệch với giờ máy chủ không quá 5 giây
-    'checksecret' => '...', // Mã bí mật mỗi lần resquest = md5($timestamp.'_'.$apisecret);
+    'hashsecret' => '...', // Mã bí mật mỗi lần resquest = password_hash($apisecret . '_' . $timestamp, PASSWORD_DEFAULT);
     'action' => 'GetLesson', // Tên API được list bên dưới
     'module' => 'elearning', // Module xử lý, ở đây là elearning, để trống thì là API của hệ thống
@@ Dòng 66: / Dòng 72: @@
     'apikey' => '...',
     'timestamp' => $timestamp,
-    'checksecret' => md5($timestamp . '_' . $apisecret),
+    'hashsecret' => password_hash($apisecret . '_' . $timestamp, PASSWORD_DEFAULT),
     'language' => 'vi',
     'action' => 'CreatArticle',
@@ Dòng 101: / Dòng 107: @@
     'apikey' => '...',
     'timestamp' => $timestamp,
-    'checksecret' => md5($timestamp . '_' . $apisecret),
+    'hashsecret' => password_hash($apisecret . '_' . $timestamp, PASSWORD_DEFAULT),
     'language' => 'vi',
     'action' => 'CreatArticle',
@@ Dòng 134: / Dòng 140: @@
 </code>
-===== Dành cho nhà phát triển muốn cung cấp remote API =====
-Để remote api hoạt động cần đảm bảo các yếu tố sau:
-  - Tại chức năng **Thiết lập Cross-Site** ở phần **Cấu hình => Thiết lập an ninh** cần tắt bảo vệ ngoài site hoặc thêm tên miền hoặc IP cho phép gọi API
-  - Tại chức năng **Cấu hình => Cấu hình chung** cần Bật **Remote API**
-  - Quyền truy cập API tại phần **Quản trị => Quyền truy cập API** đã chọn đủ API Role có chứa API cần gọi.
 ==== API của module ====
@@ Dòng 293: / Dòng 292: @@
 <code php>
-Api::ADMIN_LEV_GOD; // 3: Quản lý module
+Api::ADMIN_LEV_GOD; // 1: Admin tối cao
 Api::ADMIN_LEV_SP; // 2: Điều hành chung
-Api::ADMIN_LEV_MOD; // 1: Admin tối cao
+Api::ADMIN_LEV_MOD; // 3: Quản lý module
 </code>
@@ Dòng 373: / Dòng 372: @@
 $this->result->set($key, $value);
 </code>
+** Bước 3 thêm giá  trị api vào file ngôn ngữ của module **
+  * $lang_module['api_modulename']
+  * $lang_module['api_modulename_class']
 ==== API của hệ thống ====
@@ Dòng 381: / Dòng 384: @@
   * namespace là ''namespace NukeViet\Api;''
+==== Cách gọi API nội bộ ====
+Ta có thể dùng hàm ''nv_local_api'', cụ thể như sau
+<code php>
+$return = nv_local_api($cmd, $params, $adminidentity = '', $module = '');
+</code>
+Trong đó:
+  * $return: là kết quả API trả về
+  * $cmd: là tương ứng với action khi remote
+  * $params: là mảng data nó sẽ được chuyển thành biến $_POST
+  * $adminidentity: là userid hoặc username của admin
+  * $module: tương ứng với module khi remote
+Ví dụ: Với cách gọi qua CURL thông thường, ta cần phải làm các bước sau:
+<code php>
+$agent = 'NukeViet Remote API Lib';
+$safe_mode = (ini_get('safe_mode') == '1' || strtolower(ini_get('safe_mode')) == 'on') ? 1 : 0;
+$open_basedir = ini_get('open_basedir') ? true : false;
+$ch = curl_init();
+curl_setopt($ch, CURLOPT_URL, '...'//URL của API);
+curl_setopt($ch, CURLOPT_HEADER, 0);
+if (!$safe_mode and !$open_basedir) {
+     curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
+     curl_setopt($ch, CURLOPT_MAXREDIRS, 10);
+}
+$params= [
+    'apikey' => '...', // Khóa được cung cấp
+    'timestamp' => '...', // Thời gian resquest sai lệch với giờ máy chủ không quá 5 giây
+    'hashsecret' => '...', // Mã bí mật mỗi lần resquest = password_hash($apisecret . '_' . $timestamp, PASSWORD_DEFAULT);
+    'action' => 'GetUsername', // Tên API hoặc action khi remote
+    'module' => 'user', // Module xử lý, ở đây là user, để trống thì là API của hệ thống
+    'language' => 'vi' // Bắt buộc nếu API của module trên site đa ngôn ngữ
+    //Các dữ liệu cần thiết, ví dụ ở đây ta sẽ truyền userid
+    'userid' => $userid
+];
+$str = http_build_query($request);
+curl_setopt($ch, CURLOPT_TIMEOUT, 20);
+curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+curl_setopt($ch, CURLOPT_USERAGENT, $agent);
+curl_setopt($ch, CURLOPT_POST, sizeof($request));
+curl_setopt($ch, CURLOPT_POSTFIELDS, $str);
+$return = curl_exec($ch);  //Dữ liệu API sẽ trả về
+curl_close($ch);
+</code>
+Với hàm ''nv_local_api'', ta sử dụng:
+<code php>
+$params= [
+     'userid' => $userid
+];
+$return = nv_local_api('GetUsername', $params, 'admin', 'user');
+/*
+ Với:
+  * $return: Dữ liệu API sẽ trả về
+  * 'GetUsername': Tên API hoặc action khi remote
+  * $params: Mảng dữ liệu truyền vào API
+  * 'admin': username của tài khoản admin
+  * 'user': Module xử lý
+*/
+</code>
+Có thể xem thêm về hàm ''nv_local_api'' tại: ''.../includes/function.php''
+===== Gỡ lỗi API =====
+==== Lệnh gọi API rewrite (không gọi vào /api.php) lỗi 404 ====
+Kiểm tra xem máy chủ có hỗ trợ rewrite hay không là điều kiện đầu tiên. Nếu có hỗ trợ thì check lần lượt các hướng bên dưới.
+**Nếu máy chủ sử dụng Apache**
+  * Tìm trong httpd.conf (hoặc các file config tương đương) thẻ ''%%<Directory "path/to/your/dir">%%'' nếu có ''%%Options .... MultiViews%%'' thì xóa MultiViews sau đó khởi động lại apache.
+  * Tìm trong .htaccess ngay thư mục gốc website nếu không có thì thêm vào đoạn sau
+<code>
+<IfModule mod_negotiation.c>
+    Options -MultiViews
+</IfModule>
+</code>
+  * Nếu thêm vào vẫn không hoạt động thì cần cài thêm [[https://httpd.apache.org/docs/2.4/mod/mod_negotiation.html|mod_negotiation]]