Gandiサービスを管理するための網羅的で無料で使える安全なAPI

REST APIでGandiが提供しているドメイン名などサービスの管理を簡素化できます。操作を一括で実行できるようになり、Gandiでのサービス管理を自動化することができます。詳細はドキュメンテーションをご確認ください。

APIドキュメンテーション

ドメイン名、DNS、ウェブホスティング、メールボックス、SSL証明書を自動管理

APIを介して利用できる権限のシステムを通して、共同編集者が役割の制限内で作業できるようにし、 チームワークとセキュリティが保証されます。

  • ドメインAPI

    ドメインの登録、更新、移管を簡単に行えます。

    ドメインAPIを使い始める

  • 支払い関連 API

    商品の価格を確認し、プリペイドアカウントに入金して注文をすることができます。

    支払い関連APIを確認

  • LiveDNS API

    LiveDNSを使用して、 DNSSEC、DNSゾーン、およびスナップショットなどドメイン関連サービスを管理できます。

    LiveDNS API を確認

  • メール API

    ドメインに関連付けられたメールボックスを作成、管理、および削除することができます。

    メール APIを確認

  • Web Hosting API

    Manage your web Hosting instances

    See our Web Hosting API
REST 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.

RasberryPI、警報システム、ホームオートメーションシステムなど、ドメイン名 (myserver.example.netなど) を介して接続することで、自宅のパーソナルサービスにいつでも確実にアクセスできます。

# Update a DNS record with an new IP address
 
$ 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を介して行うこともできます。

# List expiration dates of all your domains, every day.
 
# 1. List all your domains names
$ curl --request GET
  --url  https://api.gandi.net/v5/domain/domains
  --header "authorization: Apikey ${API_KEY}" |  jq -r .[].fqdn
 
# 2. Retrieve a specific domain name's expiration date
$ 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ゾーン変更通知をパーソナライズする

機密性の高いドメイン名を管理している場合、ゾーンの変更を自動的に監視することが適切な場合があります。

以下の操作が可能です。

  • 他のイベントと関連付けるために、独自のツールから変更を監視
  • セキュリティチームなどの他のチームに変更を自動的に警告して、新しいサーバーや通信チームなどで検証を実行
  • 削除行数が多すぎるなどの考えられるエラーを検出
# 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のAPIを自社サービスで活用する

  • あなたは顧客のドメイン名やサーバーの管理を担当していますか?

    ドメイン名のライフサイクルに不可欠な全ての操作 (作成、更新、転送、連絡先の作成、サーバーとDNSゾーンの管理...) を迅速に実行することができます。

  • 自社ユーザーにドメイン名を登録させたい場合

    GandiのAPIを活用することで、Gandiが提供するサービスを自社のプラットフォーム上で使うことができます。 自社サービスの内容を豊富にし、ホスティングサービスやDNS関連のサービスを提供している企業など、自社プラットフォーム上だけでサービスが完結するようにすることができます。

  • ホワイトラベルインターフェイスを活用

    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を使ったドメイン管理の例

APIを介してドメイン名タグを管理

APIを介してドメイン名タグを管理

ドメイン名のタグを作成、変更、追加、または削除して、管理を簡単にすることができます。例えば他の誰かがあなたのブランド名を使用してドメイン名を登録されるのを防ぐために登録したドメイン名にわかりやすくタグを付けておきたい場合、"defensive registration" タグを付けるとよいです。

$ 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\"}"

1つのコマンドで連絡先確認メールを再送信

1つのコマンドで連絡先確認メールを再送信

顧客が確認メールを受信/確認/承認しなかった場合は、1つのコマンドで確認メールを再送信できます。

$ 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 クラウド VPS API: infra-as-code を活用する

Gandi クラウド VPSサーバーの構成には、自社が普段使っている方法とツールを使用することができます。

VPSサーバーの構成と配信にOpenstackを使用することは、日常的なサーバーに関するニーズにとって実用的です。

  • 各サーバーとGandi クラウドリソースはOpenstack のパブリック APIからデプロイでき、既に使用しているクラウドインフラストラクチャと同じ方法で使用できます。
  • また、Terraform、Ansible、Cloudinit、Puppet などの他のクラウドプロバイダで導入したものと同じ管理方法 (デプロイ、インフラ設定) を使用することもできます。
  • Gandi クラウドのパブリック VPS APIは、通常のサーバー管理ツールを使用して、サーバーとインフラストラクチャをコードとしてのインフラストラクチャとして管理する手段を提供します。

TerraformとCloudinitを使用して、Jitsiビデオ会議アプリケーションを自動的に展開することができます。

TerraformとCloudinitを使用して、Jitsiビデオ会議アプリケーションを自動的にデプロイすることができます。

TerraformとCloudinitを使用すると、Gandiクラウドサーバーにビデオ会議ツールをたった5分でインストールすることができます。

  1. Terraform を介したサーバーの自動デプロイ
  2. Terraform を介したSSL証明書の生成とDNSゾーンの変更
  3. Cloudinit を利用したサーバーへの Jitsi の自動ダウンロードとインストール
# main.tf terraform file extract
 
# GandiCloud VPS V-R2 server creation
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 のVPSサーバーは、全てのアプリケーションをホストするための信頼性と最新性を備えています。

Gandi クラウド VPS サーバーについてもっと知る

Gandi の API について

  • 信頼できるテスト環境

    Gandiが提供する v5サンドボックスを利用し、API操作の多くを安全にテスト

  • 24時間体制のサービス

    3大陸にまたがる社内の技術専門家が6か国語でサポート

  • 顧客体験が最優先事項

    お客様からのフィードバックは貴重であり、サービスの改善の源です。 APIをどのように使用しますか? お気軽にお問い合わせください。

Frequently asked questions

An API, or "application programming interface," is a set of rules that will allow software to easily communicate and exchange data, bilaterally.

Using an API means saving time, since, for any given program or service, data teams no longer need to develop their own application, but can just use the API associated with it. That's why APIs are now essential in all areas of online business.

For example, using the Gandi API, you can automate information processing by automatically exchanging data with Gandi's servers, and thereby automating the management of your domain names, web hosting or even email accounts.

The Gandi API is a RESTful API utilizing both HTTPS protocol and JSON. To date, these are the most widely used standard for APIs.

All documentation on API features and implementation of our API is available at https://api.gandi.net/docs/.

The Gandi API simplifies the management of your products. It allows you to very easily create custom applications that enable you to perform actions related to your Gandi services.
The objective is to automate a large number of potential actions across all products and services:

Concretely, the API is your partner in executing very easy, repetitive (or a large number of) tasks that would be difficult to complete manually using the classic web interface.

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.

お問い合わせ

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.

Use form instead