API

@MAINT Mình sẽ ví Zalo như là cái "ngân hàng" chứa thông tin cá nhân của tất cả người dùng trên Zalo. Bên ngoài ngân hàng có "một ông bảo vệ" gác cổng. Muốn vào ngân hàng lấy thông tin của một người dùng thì bạn phải xuất trình một tấm vé cho ông bảo vệ kiểm tra. Tấm vé này gọi là Access Token. Khi xuất trình một Access Token hợp lệ thì bạn có thể gọi API của Zalo để lấy thông tin của người dùng (được cho phép bởi người dùng) về hệ thống của mình và sử dụng.

Sau khi đăng ký một cái app zalo, để lấy Access Token hệ thống của bạn sẽ cần làm 2 bước. Trong đó, bước bạn thắc mắc là bước đầu tiên.

Các tham số:

• app_id: Là ID của cái app mà bạn vừa đăng ký ở trên. Có thể xem trong trang Quản lý ứng dụng.
• redirect_uri: Là một cái đường link tới hệ thống của bạn, sẽ được zalo gọi ngược về hệ thống của bạn sau khi kết thúc bước 1 này, nó gọi là Callback URL. Cái Callback URL này phải giống như cái link mà bạn cài đặt trong trang Quản lý ứng dụng của mình nhé.
• state: Là một chuỗi bất kỳ bạn chèn vào từ ứng dụng của bạn chèn, zalo ko dùng cái này, nó sẽ gửi trả lại vào trong cái trang redirect_uri kia cho bạn thôi.

Sau khi request cái API ở bước 1, hệ thống zalo sẽ yêu cầu người dùng đăng nhập vào zalo rồi xác nhận rằng họ đồng ý cấp quyền cho ứng dụng của bạn truy cập vào zalo để lấy thông tin cá nhân của người dùng đó. Nếu người dùng đồng ý, thì zalo sẽ sinh ra một cái mã gọi là oauth_code, và gửi nó tới cái trang redirect_uri mà bạn vừa gửi cho zalo ở trên. Bạn sẽ sử dụng cái oauth_code vừa nhận được để thực hiện tiếp bước 2 và nhận Access Token.