Integre Short Message Service en sus sistemas empresariales mediante llamadas directas a la API HTTP o con un SDK oficial. Así podrá enviar códigos de verificación, notificaciones y mensajes de marketing de forma programática. Este tema aborda los conceptos principales de la integración y le ayuda a elija el enfoque adecuado.
Notas de uso
Short Message Service ofrece operaciones de OpenAPI para enviar mensajes y consultar registros. Antes de integrar el servicio, revise la versión de la API, los endpoints y las identidades de llamada compatibles con Short Message Service.
What is OpenAPI? describe el flujo completo de llamadas, las identidades, la autorización y las credenciales.
Guía de versiones
Alibaba Cloud OpenAPI utiliza números de versión para gestionar las listas de API. La versión de la API de Short Message Service es 2018-05-01. La cadena 2018-05-01 es un identificador de versión, no una fecha; las API corresponden a la versión más reciente disponible y no a un conjunto obsoleto del 2018-05-01.
|
Número de versión de la API |
Descripción |
|
Recomendada |
Endpoints
Un endpoint es el nombre de dominio que se usa para acceder a la API de un servicio en la nube. Elija el endpoint más cercano a sus recursos para reducir la latencia.
Use el endpoint de Singapore dysmsapi.ap-southeast-1.aliyuncs.com.
Todos los endpoints disponibles se enumeran en Endpoints.
Identidades compatibles
El portal de OpenAPI selecciona de forma predeterminada su cuenta de Alibaba Cloud para depurar la API. Esta cuenta tiene acceso total a la API, lo que representa un riesgo de seguridad alto. Por ello, utilice un usuario de Resource Access Management (RAM) para las llamadas a la API y las tareas diarias de operación y mantenimiento. Otorgue únicamente los permisos obligatorios a cada usuario de RAM antes de invocar las operaciones de la API.
|
Identidad de usuario |
Compatible |
|
Compatible |
|
|
RAM user (Recomendado) |
Compatible |
|
RAM role (Recomendado) |
Compatible |
Métodos de integración
Se recomienda utilizar los SDK para invocar las operaciones de OpenAPI. Siempre que sea posible, use un SDK.
|
Método de integración |
Descripción |
|
SDK de Alibaba Cloud (Recomendado) |
|
|
Llamadas personalizadas a la API (No recomendado) |
Las llamadas HTTP nativas requieren implementar el algoritmo de firma y construir las solicitudes manualmente. El mecanismo de firma se documenta en V3 request body and signature mechanism. |
Referencias
Si una llamada a la API devuelve un error, compruebe los parámetros de la solicitud en API error codes.
Registre el RequestID de la respuesta o del mensaje de error del SDK. Después, utilice la plataforma de diagnóstico de Alibaba Cloud OpenAPI para diagnosticar el problema.
Identities, credentials, and authorization explica los tipos de identidad de llamada, las credenciales y la autorización.
Alibaba Cloud limita la frecuencia de las llamadas de OpenAPI . Los límites de velocidad y las cuotas se documentan en Throttling and cuota management.