國內首款go語言閘道器!GoKu API Gateway CE 快速使用手冊
通過閘道器訪問的完整請求地址為 閘道器IP:埠號/閘道器別名/策略組id/介面路徑
下面將介紹通過配置檔案快速使用 GoKu API Gateway CE 。
一.建立閘道器
- 1、開啟全域性配置檔案 goku.conf ,輸入以下資訊:
1.host: ""
2.port: "6600"
3.gateway_conf_path: ./config/gateway
- 2、開啟閘道器配置檔案 gateway.conf ,輸入以下資訊:
1.gateway_name: 示例閘道器
2.gateway_alias: asp
3.gateway_status : on
4.ip_limit_type: none
5.api_group_conf_path: ./config/gateway/asp/api_group.conf
6.api_conf_path: ./config/gateway/asp/api.conf
7.strategy_conf_path: ./config/gateway/asp/strategy.conf
8.backend_conf_path: ./config/gateway/asp/backend.conf
二.新增後端服務
開啟後端服務配置檔案 backend.conf ,輸入以下資訊:
1.backend:
2.- backend_id: 1
3. backend_name: apishop
4. backend_path: https://api.apishop.net
三.新建策略組
每個閘道器下可以新建多個策略組,策略組包含 鑑權方式、流量控制、IP黑白名單 等模組,一個策略組可以指定多個 API組,API請求地址務必加上相應的 策略組id 。
在此採用無鑑權的方式、無ip黑白名單、流控為1次/秒,開啟策略組配置檔案 strategy.conf ,輸入以下資訊:
1.strategy:
2.- strategy_name: 示例策略
3. strategy_id: test
4. auth: none
5. ip_limit_ type: none
6. rate_limit_list:
7. - allow: true
8. period: "sec"
9. limit: 1
10. priority: 999
11. start_time: 0
12. end_time: 24
四.新建API分組
開啟API分組配置檔案 api_group.conf ,輸入以下資訊:
1.group:
2.- group_id: 1
3. group_name: 示例分組1
4.- group_id: 2
5. group_name: 示例分組2
五.新建API
在此使用 介面商店 (apishop.net) 的 全國油價查詢API 作為要通過閘道器訪問的示例介面,下面的教程展示如何在GoKu閘道器配置該介面。
該介面的請求引數如下:
引數名 | 型別 | 必填 | 說明 |
---|---|---|---|
apiKey | long | 是 | 申請資料後可在apishop控制檯檢視 |
province | text | 否 | 省份名,比如廣西、北京 |
開啟API配置檔案 api.conf ,輸入以下資訊:
1.apis:
2.- api_name: 全國油價
3. group_id: 1
4. backend_id: 1
5. request_method:
6. - post
7. - get
8. request_url: /common/oil/getOilPriceToday
9. proxy_method: post
10. proxy_url: /common/oil/getOilPriceToday
11. proxy_body_type: formdata
12. porxy_body:
13. proxy_params:
14. - key: province
15. key_position: body
16. not_empty: false
17. proxy_key: province
18. proxy_key_position: body
19. constant_params:
20. - key: apiKey
21. position: body
22. value: Uad5kkL53ced1ca67f*****************
六.訪問閘道器
通過閘道器訪問的完整請求地址為 閘道器IP:埠號/閘道器別名/策略組id/介面路徑
所以該API通過閘道器的完全請求路徑為
http://localhost:6600/asp/test/common/oil/getOilPriceToday
在此使用 eoLinker介面管理平臺 進行測試。
傳送請求後得到正確結果:
至此,您已成功瞭解GoKu API Gateway CE,如您在使用過程中依然存有問題,歡迎各位加入我們的使用者討論群,我們的技術同事將會為您解答:使用者交流1群 (群號:725853895) 。
想了解更多國內首款GO語言閘道器資訊,請留意:https://agw.eolinker.com,或者關注本部落格,部落格將會及時更新eoLinker旗下產品最新資訊。
相關文章:
國內首款GO語言閘道器!GoKu API Gateway部署指南
GoKu API Gateway CE 配置檔案
GoKu API Gateway CE golang安裝與設定