Domain Names:Vue d'ensemble de l'intégration

Présentation d'OpenAPI

Alibaba Cloud met à votre disposition OpenAPI Explorer, une plateforme intégrant la recherche d'API, la documentation, le débogage en ligne, la génération de SDK, des exemples de code, le diagnostic des appels et des statistiques. OpenAPI Explorer génère également des exemples de code SDK pour vous aider à démarrer rapidement. Pour plus d'informations, consultez la rubrique Qu'est-ce qu'OpenAPI ?.

Versions

Alibaba Cloud OpenAPI utilise des numéros de version pour gérer les API lors des mises à jour majeures des produits. Domain Names prend actuellement en charge la version d'API 2018-01-29. Cette valeur est un identifiant de version, et non une date. Elle permet toujours d'accéder aux dernières données d'API publiques, même si l'API a pu être mise à jour depuis le 2018-01-29.

Débogage en ligne

Pour appeler une API, vous devez connaître sa version, son endpoint, son style et les méthodes d'appel prises en charge.

Par exemple, pour utiliser l'API SaveSingleTaskForCreatingOrderActivate (soumettre une tâche d'enregistrement de domaine), sélectionnez l'API cible dans le volet de navigation de gauche d'OpenAPI Explorer. Dans la zone centrale, choisissez un endpoint, tel que China (Hangzhou), et saisissez les paramètres de requête. Ces paramètres incluent le champ obligatoire DomainName (le domaine que vous souhaitez enregistrer), SubscriptionDuration (période d'achat), RegistrantProfileId (ID du profil de domaine), EnableDomainProxy (activation ou non de la protection de la confidentialité du domaine) et PermitPremiumActivation (autorisation ou non de l'enregistrement d'un domaine premium). Ensuite, cliquez sur Initiate Request. Vous pouvez consulter la description de l'API et la documentation des paramètres de requête dans le panneau de droite.

Point d'entrée pour le débogage

La page de débogage est disponible à l'adresse suivante : Page de débogage de l'API Domain Names.

Endpoints

Pour minimiser la latence, sélectionnez l'endpoint correspondant à la région où se trouvent vos ressources.

Endpoint pour Singapour : domain-intl.aliyuncs.com.

Style d'API

Style RPC.

Identité

Par défaut, OpenAPI Explorer utilise l'identité de votre compte Alibaba Cloud pour les appels d'API. Étant donné que ce compte dispose d'un accès complet à l'API, nous vous recommandons vivement de créer un utilisateur RAM pour l'accès à l'API et les opérations quotidiennes. Accordez à l'utilisateur RAM les autorisations Domain Names requises avant d'effectuer des appels d'API. Pour plus d'informations, consultez la rubrique Créer un utilisateur RAM pour effectuer des opérations Domain Names.

Informations complémentaires

• Identité, identifiants et autorisation

• Limitation de débit et gestion des quotas

Méthodes d'intégration

• SDK Alibaba Cloud

  • Alibaba Cloud propose des SDK pour Java, C#, Go, Python, Node.js/TypeScript, PHP et C++. Les SDK encapsulent la logique de signature, la gestion des délais d'attente et la logique de nouvelle tentative, et fournissent des objets Request et Response pour simplifier le développement. Pour plus d'informations, consultez la rubrique SDK Alibaba Cloud.

  • Vous pouvez utiliser le SDK Domain Names pour appeler l'API OpenAPI. Pour obtenir des informations sur les langages pris en charge et sur l'installation des dépendances, consultez la rubrique Exemples de code du SDK pour Java.

• CLI Alibaba Cloud

  • Le CLI Alibaba Cloud vous permet d'exécuter des commandes aliyun pour interagir avec les services Alibaba Cloud et gérer les ressources de service cloud depuis votre terminal. Pour plus d'informations, consultez la rubrique Qu'est-ce que le CLI Alibaba Cloud.

  • Le CLI Alibaba Cloud ne prend pas actuellement en charge les API Domain Names.

• Terraform

  • Terraform est un outil open source permettant de prévisualiser, de provisionner et de gérer l'infrastructure cloud en traduisant les modèles en appels d'API. Pour plus d'informations, consultez la rubrique Qu'est-ce qu'Alibaba Cloud Terraform ?.

  • Terraform ne prend pas actuellement en charge les API Domain Names.

• Resource Orchestration Service (ROS)

  • Resource Orchestration Service (ROS) automatise le provisionnement des ressources cloud via des modèles. Vous définissez les ressources requises et leurs dépendances dans un modèle, et ROS les crée et les configure automatiquement. Pour plus d'informations, consultez la rubrique Qu'est-ce que Resource Orchestration Service.

  • ROS ne prend pas actuellement en charge les API Domain Names.

• Appels d'API personnalisés

  • Pour effectuer des appels HTTP natifs, vous devez implémenter l'algorithme de signature, construire une requête personnalisée et initier l'appel HTTP. Pour plus d'informations sur le mécanisme de signature, consultez les rubriques Structure de requête V3 et signature.

Notes d'utilisation

• Si un appel d'API Domain Names renvoie une erreur, utilisez le code d'erreur pour vérifier que vos paramètres de requête et vos valeurs sont corrects.

• Vous pouvez également enregistrer l'ID de requête figurant dans la réponse ou le message d'erreur du SDK, puis utiliser la Plateforme de diagnostic OpenAPI d'Alibaba Cloud pour effectuer un diagnostic en libre-service.