Skip to main content
Este documento presentará una descripción de la integración de la API de URL corta, que puede convertir URLs largas en URLs cortas.

​
Proceso de solicitud

Para usar la API de URL corta, primero dirígete a la consola de Ace Data Cloud para obtener tu token de API, guárdalo para uso futuro. Si aún no has iniciado sesión o registrado, serás redirigido automáticamente a la página de inicio de sesión que te invitará a registrarte e iniciar sesión; una vez completado, volverás automáticamente a la página actual. Un token de API es suficiente para acceder a todos los servicios de la plataforma, no es necesario solicitar uno por cada servicio. La primera solicitud incluirá un crédito gratuito para que puedas probarlo; si el crédito es insuficiente, puedes recargar el saldo general en la consola.
📘 Documentación completa: API de URL corta →

​
Uso básico

Primero, debes entender la forma básica de uso, que consiste en ingresar la URL larga que deseas convertir, y así obtener el resultado procesado; primero necesitas pasar un campo content. A continuación, podemos completar el contenido correspondiente en la interfaz, como se muestra en la imagen:

Aquí podemos ver que hemos configurado los encabezados de la solicitud, que incluyen:
  • accept: el formato de respuesta que deseas recibir, aquí se establece como application/json, es decir, formato JSON.
  • authorization: la clave para llamar a la API, que puedes seleccionar directamente después de solicitarla.
Además, se ha configurado el cuerpo de la solicitud, que incluye:
  • content: el contenido de la URL que se va a acortar.
Después de seleccionar, puedes notar que también se ha generado el código correspondiente a la derecha, como se muestra en la imagen:

Haz clic en el botón “Try” para realizar la prueba, como se muestra en la imagen anterior, aquí hemos obtenido el siguiente resultado:
El resultado devuelto tiene varios campos, que se describen a continuación:
  • success, el estado de si la tarea fue exitosa.
  • data, que contiene la URL convertida.
Se puede ver que la URL larga original https://platform.acedata.cloud/documents/shorturl se ha convertido exitosamente en la URL corta https://surl.id/1uHCs01xa5. Además, si deseas generar el código de integración correspondiente, puedes copiarlo directamente, por ejemplo, el código de CURL es el siguiente:
El código de integración en Python es el siguiente:

​
Manejo de errores

Al llamar a la API, si encuentras un error, la API devolverá el código de error y la información correspondiente. Por ejemplo:
  • 400 token_mismatched: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
  • 400 api_not_implemented: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
  • 401 invalid_token: No autorizado, token de autorización inválido o faltante.
  • 429 too_many_requests: Demasiadas solicitudes, has superado el límite de tasa.
  • 500 api_error: Error interno del servidor, algo salió mal en el servidor.

​
Ejemplo de respuesta de error

​
Conclusión

A través de este documento, has aprendido cómo usar la API de URL corta para convertir URLs largas en URLs cortas. Esperamos que este documento te ayude a integrar y utilizar mejor esta API. Si tienes alguna pregunta, no dudes en contactar a nuestro equipo de soporte técnico.