Notes de version sur l’API de domaines
Voici les notes de publication de l’API Domaines. Nous veillerons à vous tenir au courant des mises à jour de fonctionnalités à venir et des nouvelles offres.
Avril 2020
- Modifications de la confidentialité WHOIS
- Désormais disponible: .APP, .DEV et .PAGE
- TLD Revendications de marques indéfinies
- Limites d'enregistrement de zone DNS
- Taille de la page d'enregistrement de zone DNS
Modifications de la confidentialité WHOIS
Le 1er juillet 2020, nous améliorerons notre offre de confidentialité pour vous permettre de mieux contrôler la façon dont vous gérez la confidentialité de vos domaines. Tout d'abord, vous pourrez activer ou désactiver la confidentialité sans annuler ni réacheter le produit. Lors du premier ajout de la confidentialité à un domaine, les informations de contact du proxy seront utilisées pour remplacer vos informations de contact personnelles en réponse aux requêtes WHOIS. Pour exposer temporairement vos informations de contact personnelles dans WHOIS, un nouvel attribut exposWhois est en cours d'introduction, ainsi qu'une nouvelle clé d'accord pour vérifier le consentement à exposer les données de contact personnelles, comme suit:
PATCH /v1/domains/mydomain.com "consent": {"consentAt": "2020-03-30T10: 00: 00Z", "convenuBy": "12.13.14.15", "agreementKeys": ["EXPOSE_WHOIS"]} , "exposerWhois": "true"
Les informations de contact du proxy peuvent être restaurées à l’aide de la commande suivante, sans clé d’accord requise:
PATCH /v1/domains/mydomain.com "exposerWhois": "false"
En outre, à compter du 1er juillet 2020, nous proposons une protection de base gratuite de la confidentialité sur tous les nouveaux domaines et sur les domaines existants qui ne disposent pas de notre protection avancée de la confidentialité. La confidentialité de base masquera la plupart des données de contact personnelles dans les requêtes WHOIS, exposant uniquement le nom de la société, le pays et l’état. Pour les domaines bénéficiant d'une protection de base de la confidentialité, les informations de contact personnelles peuvent éventuellement être exposées ou masquées dans le WHOIS à l'aide des mêmes commandes API décrites ci-dessus.
Désormais disponible: .APP, .DEV et .PAGE
À partir du 28 avril 2020, les utilisateurs de l'API peuvent enregistrer des domaines .APP, .DEV et .PAGE, avec un hébergement spécial. .APP, .DEV et .PAGE sont désignés comme espaces de noms sécurisés. Tous les principaux navigateurs exigent que les domaines de ces espaces de noms disposent d'un certificat SSL.
Les déposants ne sont pas tenus d'acheter un certificat SSL comme condition préalable à l'achat de leur domaine, mais les fournisseurs de noms de domaine sont tenus d'informer leurs déposants au moment de l'enregistrement qu'ils auront besoin d'un certificat SSL pour servir leur domaine dans un navigateur. . -
Les détails complets sur cette exigence sont disponibles via la méthode API suivante:
GET / v1 / domaines / accords? Tlds = APP
À l’appui de ces TLD spéciaux, une clé d’accord supplémentaire appelée HTTPS_NOTICE est introduite dans la section de consentement dans le corps du point de terminaison d’achat pour que les utilisateurs reconnaissent qu’ils ont examiné cette exigence et souhaitent procéder à l’enregistrement. En incluant cette nouvelle clé d’accord obligatoire, la section de consentement d’une demande d’achat valide ressemblerait à ceci:
POST / v1 / domains / achat "domaine": "mydomain.app", "consent": {"consentAt": "2020-03-30T10: 00: 00Z", "consentitBy": "12.13.14.15", "accordKeys ": [" DNRA "," HTTPS_NOTICE "]}, ...
TLD Revendications de marques indéfinies
13 TLD supplémentaires sont désormais disponibles via l'API: .ACCOUNTANT, .CRICKET, .DATE, .DOWNLOAD, .FAITH, .LOAN, .MEN, .PARTY, .RACING, .REVIEW, .SCIENCE, .STORAGE et .WIN. Ces TLD sont soumis à une période de revendication de marque illimitée. Actuellement, les domaines de ces 13 espaces de noms qui comportent des revendications de marque sont traités comme indisponibles. Un domaine sans revendication de marque peut être acheté normalement.
Limites d'enregistrement de zone DNS
Pour garantir l'évolutivité de nos fonctionnalités de gestion DNS pour tous les clients, nous implémentons des limites sur le nombre d'enregistrements pouvant être créés dans une seule zone. À partir du 28 avril 2020, les clients DNS standard peuvent créer jusqu'à 500 enregistrements par zone, et les clients DNS premium peuvent créer jusqu'à 1500 enregistrements par zone. Cette modification affectera les points de terminaison suivants:
PUT / v1 / domaines / {domain} / enregistrements PUT / v1 / domaines / {domain} / enregistrements / {type} PUT / v1 / domaines / {domain} / enregistrements / {type} / {name} PATCH / v1 / domaines / {domain} / enregistrements
Lorsqu'un des points de terminaison ci-dessus est appelé, nous évaluons si la mise à jour demandée de la zone entraînerait un dépassement de la limite d'enregistrement par la zone. Dans le cas contraire, nous traiterons la demande normalement. Si c'est le cas, nous renverrons une réponse 422 avec les détails de l'erreur suivants:
code: ZONE_LIMIT_EXCEEDED message: La zone ne peut pas dépasser 500 enregistrements; l’opération demandée dépasserait la limite.
Pour les zones qui dépassent actuellement la limite, tous les enregistrements existants resteront intacts. Cependant, aucun nouvel enregistrement ne peut être ajouté tant que le nombre total d'enregistrements de zone n'est pas ramené dans la limite d'enregistrement, ce qui peut être effectué à l'aide de la méthode PUT.
Taille de la page d'enregistrement de zone DNS
Lors de la récupération d'enregistrements dans une zone, le paramètre limit est utilisé pour indiquer le nombre d'enregistrements à récupérer. Pour garantir l'évolutivité du système, le 28 avril 2020, nous appliquerons une limite maximale de 500 enregistrements. Cette modification affectera les points de terminaison suivants:
GET / v1 / domaines / {domain} / enregistrements GET / v1 / domaines / {domain} / enregistrements / {type}
Quand une demande est reçue avec une limite supérieure à 500, nous renverrons une réponse 422 avec les détails d'erreur suivants:
code: Message VALUE_OVER: La valeur limite ne doit pas dépasser 500.
Les utilisateurs pourront toujours parcourir tous leurs enregistrements de zone dans des tailles de page allant jusqu'à 500, en utilisant les paramètres de décalage et de limite.