自動管理網域名稱、DNS、網頁代管主機、電子信箱以及 SSL 憑證
透過 API 提供的權限系統,恢復您的個人 API 金鑰,並且讓您的合作夥伴在專屬的角色範圍內工作,如此一來,能保障您的團隊合作與安全
域名 API
瞭解域名 API輕鬆地註冊、續約或移轉您的域名
付款與帳務 API
瞭解帳務 API驗證產品價格、儲值您的預付帳戶以及替您下單
LiveDNS API
瞭解 LiveDNS API運用 LiveDNS API 管理您的域名、DNSSEC、DNS 區域檔以及快照備份
電子信箱 API
瞭解電子信箱 API建立、管理或刪除您域名下的電子信箱
Web Hosting API
See our Web Hosting APIManage your web Hosting instances
簡單好用的 API 使用範例
透過您的域名存取
透過您的域名直接在家裡存取您的自我代管伺服器
Thanks to our API, you can automatically update the IP address of your router so that the server you host at home will always be available through your domain name.
您可以透過域名 (例如:myserver.example.net) 連接家裡的個人服務,例如 RasberryPI、警報系統與智能家庭系統等。
# 用新的 IP 位址更新 DNS 紀錄 $ curl --request PUT --url https://api.gandi.net/api/v5/domains/example.net/records/mybox/A \ --header "authorization: Apikey ${API_KEY}" \ --header 'content-type: application/json' \ --data "{ \"rrset_ttl\": 300, \"rrset_values\": [\"1.2.3.4\"] }"
監控域名快來臨的到期日
監控域名快來臨的到期日
Gandi 會在域名到期日前 60 天寄送電子郵件提醒您。
但是,您可以自訂通知,以便加入工作流程,將通知發送到其他團隊的協作環境,甚至是將通知發送至您的智慧型手機,以免到期通知信被當作垃圾郵件。
您永遠不會因為到期通知信被當作垃圾郵件而忘記續約域名,或是您不想擔心這一點的話,您也可以透過 API 啟用自動續約功能。
# 每天列出您所有域名的到期日 # 1. 列出您所有的域名 $ curl --request GET --url https://api.gandi.net/v5/domain/domains --header "authorization: Apikey ${API_KEY}" | jq -r .[].fqdn # 2. 取得特定域名的到期日 $ curl --request GET --url https://api.gandi.net/v5/domain/domains/example.net --header "authorization: Apikey ${API_KEY}" | jq -r .dates.registry_ends_at
個人化 DNS 區域檔修改通知
個人化 DNS 區域檔修改通知
在有敏感域名的專業環境下,自動監控修改區域檔是有需要的。
您可以:
- 從您自己的工具監測變化,以便輕鬆地將變化與其他事件連結起來
- 當有修改 DNS 區域檔時,自動警示其他團隊 (例如:安全團隊、溝通團隊),以便他們可以在新的伺服器進行驗證。
- 偵測可能的錯誤 (例如:刪除太多行內容)
# 1. 定期取得 DNS 區域檔內容 $ curl --request GET --url https://api.gandi.net/api/v5/domains/example.net/records --header 'accept: text/plain' --header "authorization: Apikey ${API_KEY}" > ma.zone # 2. 比較不同時候的區域檔紀錄,查看在指定期間內是否有變更 # 3. 收到已經變更的通知
自動部署您的網站
自動部署您的網站
公開 API 讓您可以部署虛擬主機以及自動產生 SSL/TLS 憑證,您也可以整合您自己或客戶的網站部署至您的自動化流程中。
# List your Web Hosting instances curl -X GET \ https://api.gandi.net/v5/simplehosting/instances \ -H 'authorization: Apikey YOUR-API-KEY' # Create a Wordpress website on a web Hosting instance curl -X POST \ https://api.gandi.net/v5/simplehosting/instances/<;instance_id>/vhosts \ -H 'authorization: Apikey YOUR-API-KEY' \ -H 'content-type: application/json' \ -d '{"fqdn":"your.fqdn.tld", \ "linked_dns_zone":{"allow_alteration":"True"}, \ "application":{"name":"wordpress"}}'
Gandi 的經銷商:直接整合您的工具與 Gandi 的 API
您負責管理客戶的產品嗎?
快速執行域名使用週期的所有必要操作:註冊、續約、移轉、建立聯絡人、管理伺服器與 DNS 區域檔...
您的客戶是有自主性的嗎?
Gandi 的 API 能完整且透明地整合 Gandi 的服務與您的設計和平台,提升您的產品目錄,以提供客戶您品牌完整的生態系統,並且保持您客戶的忠實度。
Gandi 白色標籤介面的優點
Our white label tool allows your customers to easily manage their DNS zones and web forwarding via personalized, secure, and easy-to-use interface. Contact our Corporate Services team for more information.
使用 API 輕鬆管理產品與服務的範例
透過 Gandi 的 API 管理您的域名標籤
透過 Gandi 的 API 管理您的域名標籤
您可以建立、修改、新增或刪除域名標籤以方便管理域名;還是您想辨識您為了防止他人盜用您商標,而註冊的域名呢?那麼請選擇「防護性註冊」標籤。
$ curl --request POST --url https://api.gandi.net/v5/domain/domains/{domain}/tags --header "authorization: Apikey XXXXX" --header 'content-type: application/json' --data "{\"tag\": \"defensive registration\"}"
使用指令重新寄送存取確認信
使用指令重新寄送存取確認電子郵件
如果您的客戶沒有收到、沒有看到或沒有驗證您寄出的存取確認電子郵件,您只需使用一個指令,便能重新發送存取確認信。
$ curl --request PATCH --url https://api.gandi.net/v5/domain/domains/DOMAIN/reachability --header "authorization: Apikey XXXXX" --header 'content-type: application/json' --data '{"action":"resend"}'
Gandi 雲平台 (OpenStack) API:邁向基礎架構程式碼
維持您一貫的方法,使用自己的工具來設置 Gandi 雲平台 (OpenStack) 伺服器
對您的日常需求來說,使用 OpenStack 設置與傳輸伺服器是非常實用的。
- 每台伺服器與 Gandi 雲端資源都可以使用公開 OpenStack API 部署與試運行,您可以繼續用與您的私有雲端基礎架構相同的方式使用公開 OpenStack API。
- 您也可以自由地使用與其他雲端供應商一樣的部署及基礎架構控制工具,例如 Terraform、Ansible、Cloudinit 或 Puppet 等。
- Gandi 雲平台 (OpenStack) 公開 API 讓您在基礎架構程式碼 (IaC) 的模式下,使用您常用的伺服器管理工具來管理您的伺服器與基礎架構。
借助 Terraform 與 Cloudinit,自動部署 Jitsi 視訊會議應用程式
借助 Terraform 與 Cloudinit,自動部署 Jitsi 視訊會議應用程式
借助 Terraform 與 Cloudinit,只需 5 分鐘,您便能在Gandi 雲平台 (OpenStack) 伺服器上安裝好視訊會議工具:
- 透過 Terraform 自動部署伺服器
- 透過 Terraform 產生 SSL 憑證與修改 DNS 區域檔
- 透過 Cloudinit 自動下載與安裝 Jitsi 至伺服器上
# 從 Terraform 的 main.tf 組態檔中提取 # 建立 Gandi 雲平台 (OpenStack) V-R2 伺服器 resource "openstack_compute_instance_v2" "jitsi" { name = "jitsi" key_pair = openstack_compute_keypair_v2.jitsi-keypair.name flavor_name = "V-R2" security_groups = ["default"] power_state = "active" network { name = "public" } user_data = "${data.template_file.user_data.rendered}" block_device { uuid = "47edd0a0-23ce-4ce5-9168-36de68990d1b" source_type = "image" volume_size = 25 boot_index = 0 destination_type = "volume" delete_on_termination = true }
使用 Gandi API 的理由
可信賴的測試環境
多虧 Gandi 的 v5 沙盒 (sandbox),才能安全地測試許多 API 操作。
全天候不間斷的服務
Gandi 的客戶服務團隊精通 6 種語言,分佈於 3 大洲,永遠在任何您需要的時候提供您協助。
重視顧客的體驗
您的回饋意見對 Gandi 而言十分珍貴,也是促進我們改善產品的動力。Gandi 的 API 使用起來如何呢?請寫下您的寶貴意見吧!
常見問題 FAQ
API 是如何運作的呢?
Gandi API 是 RESTful API,使用 HTTPS 協議與 JSON,目前為止,上述兩種是最廣泛使用的 API 標準。
想瞭解所有關於 API 功能與執行 API 的文件,請前往 https://api.gandi.net/docs/ 查閱。
為什麼要使用 API?
Gandi API 簡化您產品的管理程序,讓您可以很輕鬆地建立自訂的應用程式,執行與您的 Gandi 服務之相關操作。
API 的目的是自動化所有產品與服務的大量潛在操作。
- 運用域名 API,註冊、續約以及移轉網域名稱
- 運用 LiveDNS API,管理 DNS
- 運用帳務 API,驗證價格與下單
- 運用電子信箱 API,管理電子信箱
- Manage web hosting instances using the Web Hosting API
具體來說,API 是您執行簡單且重複性高 (或大量的) 之任務的好夥伴,因為這些任務很難使用經典的網路介面手動完成。