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/09/01 13:55] – [API của module] webvang
+++ programming4:api [2021/10/12 15:54] – [Cách gọi API nội bộ] nguyenchiton
@@ Dòng 381: / Dòng 381: @@
+==== 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''