Domain Names:Descripción general de la integración

Introducción a OpenAPI

Alibaba Cloud proporciona OpenAPI Explorer, una plataforma que integra búsqueda de API, documentación, depuración en línea, generación de SDK, código de ejemplo, diagnóstico de llamadas y estadísticas. OpenAPI Explorer también genera código de ejemplo del SDK para ayudarle a comenzar rápidamente. Para obtener más información, consulte What is OpenAPI?.

Versiones

OpenAPI de Alibaba Cloud utiliza números de versión para gestionar las API en los principales lanzamientos de productos. Actualmente, Domain Names es compatible con la versión de API 2018-01-29. Este valor es un identificador de versión, no una fecha. Siempre proporciona acceso a los datos más recientes de la API pública, y es posible que la API se haya actualizado desde 2018-01-29.

Depuración en línea

Para llamar a una API, debe conocer su versión, endpoint, estilo y métodos de llamada compatibles.

Por ejemplo, para usar la API SaveSingleTaskForCreatingOrderActivate (enviar una tarea de registro de dominio), seleccione la API objetivo en el panel de navegación izquierdo de OpenAPI Explorer. En el área central, seleccione un endpoint, como China (Hangzhou), e introduzca los parámetros de solicitud. Estos parámetros incluyen los campos obligatorios DomainName (el dominio que desea registrar), SubscriptionDuration (periodo de compra), RegistrantProfileId (ID del perfil de dominio), EnableDomainProxy (si se habilita la protección de privacidad del dominio) y PermitPremiumActivation (si se permite el registro de un dominio premium). A continuación, haga clic en Initiate Request. Puede consultar la descripción de la API y la documentación de los parámetros de solicitud en el panel derecho.

Punto de entrada de depuración

La página de depuración está disponible en: Página de depuración de la API de Domain Names.

Endpoints

Para minimizar la latencia, seleccione el endpoint correspondiente a la región de sus recursos.

Endpoint para Singapore: domain-intl.aliyuncs.com.

Estilo de API

Estilo RPC.

Identidad

De forma predeterminada, OpenAPI Explorer utiliza la identidad de su cuenta de Alibaba Cloud para las llamadas a la API. Dado que esta cuenta tiene acceso completo a la API, le recomendamos encarecidamente crear un usuario de RAM para el acceso a la API y las operaciones diarias. Conceda al usuario de RAM los permisos necesarios de Domain Names antes de realizar llamadas a la API. Para obtener más información, consulte Create a RAM user to perform Domain Names operations.

Más información

• Identity, credentials, and authorization

• Throttling and quota management

Métodos de integración

• SDK de Alibaba Cloud

  • Alibaba Cloud proporciona SDK para Java, C#, Go, Python, Node.js/TypeScript, PHP y C++. Los SDK encapsulan la lógica de firma, el manejo de tiempos de espera y la lógica de reintentos, además de proporcionar objetos Request y Response para simplificar el desarrollo. Para obtener más información, consulte Alibaba Cloud SDK.

  • Puede utilizar el SDK de Domain Names para llamar a OpenAPI. Para obtener información sobre los lenguajes compatibles y cómo instalar las dependencias, consulte SDK for Java code examples.

• Alibaba Cloud CLI

  • Alibaba Cloud CLI le permite ejecutar comandos aliyun para interactuar con los servicios de Alibaba Cloud y gestionar recursos de servicios en la nube desde su terminal. Para obtener más información, consulte What is Alibaba Cloud CLI.

  • Actualmente, Alibaba Cloud CLI no es compatible con las API de Domain Names.

• Terraform

  • Terraform es una herramienta de código abierto para previsualizar, aprovisionar y gestionar infraestructura en la nube mediante la traducción de plantillas en llamadas a API. Para obtener más información, consulte What is Alibaba Cloud Terraform?.

  • Actualmente, Terraform no es compatible con las API de Domain Names.

• Resource Orchestration Service (ROS)

  • Resource Orchestration Service (ROS) automatiza el aprovisionamiento de recursos en la nube mediante plantillas. Usted define los recursos necesarios y sus dependencias en una plantilla, y ROS los crea y configura automáticamente. Para obtener más información, consulte What is Resource Orchestration Service.

  • Actualmente, ROS no es compatible con las API de Domain Names.

• Llamadas a API personalizadas

  • Para realizar llamadas HTTP nativas, debe implementar el algoritmo de firma, construir una solicitud personalizada e iniciar la llamada HTTP. Para obtener más información sobre el mecanismo de firma, consulte V3 request structure and signature.

Notas de uso

• Si una llamada a la API de Domain Names devuelve un error, utilice el código de error para comprobar que sus parámetros y valores de solicitud sean correctos.

• También puede registrar el ID de solicitud de la respuesta o del mensaje de error del SDK y utilizar la Plataforma de diagnóstico de OpenAPI de Alibaba Cloud para diagnósticos de autoservicio.