運用詳盡、免費又安全的 API 管理您的 Gandi 產品

Gandi 的 REST API 能簡化您的產品管理,請參閱詳細的線上文件,瞭解如何批次操作以及自動執行產品與服務。

自動管理網域名稱、DNS、網頁代管主機、電子信箱以及 SSL 憑證

透過 API 提供的權限系統,恢復您的個人 API 金鑰,並且讓您的合作夥伴在專屬的角色範圍內工作,如此一來,能保障您的團隊合作與安全

簡單好用的 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) 伺服器上安裝好視訊會議工具:

  1. 透過 Terraform 自動部署伺服器
  2. 透過 Terraform 產生 SSL 憑證與修改 DNS 區域檔
  3. 透過 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 雲平台 (OpenStack) 伺服器可靠又新穎,可以承載您所有的應用程式

瞭解 Gandi 雲平台 (OpenStack) 伺服器

使用 Gandi API 的理由

  • 可信賴的測試環境

    多虧 Gandi 的 v5 沙盒 (sandbox),才能安全地測試許多 API 操作。

  • 全天候不間斷的服務

    Gandi 的客戶服務團隊精通 6 種語言,分佈於 3 大洲,永遠在任何您需要的時候提供您協助。

  • 重視顧客的體驗

    您的回饋意見對 Gandi 而言十分珍貴,也是促進我們改善產品的動力。Gandi 的 API 使用起來如何呢?請寫下您的寶貴意見吧

常見問題 FAQ

API (application programming interface,又稱應用程式介面) 是一套規則,讓軟體可以輕鬆地雙向溝通並交換數據。

使用 API 可以節省時間,因為對於數據團隊而言,已經不再需要為了任何的程式或服務開發自己的應用程式,只需使用相關的 API,因此 API 現在於各種線上生意而言都是不可或缺的。

舉例來說,使用 Gandi API,您可以透過與 Gandi 伺服器自動交換數據來實現訊息處理的自動化,從而實現您的網域名稱網頁代管,或是電子信箱帳號的自動化管理。

Gandi API 是 RESTful API,使用 HTTPS 協議與 JSON,目前為止,上述兩種是最廣泛使用的 API 標準。

想瞭解所有關於 API 功能與執行 API 的文件,請前往 https://api.gandi.net/docs/ 查閱。

Gandi API 簡化您產品的管理程序,讓您可以很輕鬆地建立自訂的應用程式,執行與您的 Gandi 服務之相關操作。
API 的目的是自動化所有產品與服務的大量潛在操作。

具體來說,API 是您執行簡單且重複性高 (或大量的) 之任務的好夥伴,因為這些任務很難使用經典的網路介面手動完成。

Get help

新聞與優惠

查看全部

Subscribe to the Gandi API Newsletter

A dedicated email to know about important updates related to the public API. Stay informed about API enhancements and features updates.

Invalid registration

Confirmation email sent

Please check your mailbox in order to confirm your subscription.

Chat with us

The chat tool requires accepting cookies.

The chat tool requires cookies to function properly. You can see the details of the cookies used in our privacy and cookie use policy.

Accept them to continue or use our support form if you refuse them.