SDK para Python de Vonage

Vonage/vonage-python-sdk

4.0.0

14 de noviembre de 2024

Una reescritura completa del SDK. Cambios clave:

  • Estructura monorrepo, con cada API en paquetes separados
  • Compatibilidad con Python 3.9+
  • Paridad de características con v3
  • Añadir compatibilidad con las nuevas API de red: la API de red de intercambio de simulación de Vonage y el API de red de verificación de números de Vonage
  • Utilización de modelos de datos en todo
  • Muchos nuevos errores personalizados, modelos de datos de error y mensajes de error mejorados.
  • Docstrings para métodos y modelos de datos en todo el SDK con el fin de aumentar la calidad de vida de los desarrolladores y facilitar el desarrollo in-IDE.
  • Uso de Pydantic para imponer la escritura correcta en todo el sistema
  • Añadir soporte para todos API de Video de Vonage características
  • Añadir http_client a cada módulo que tenga un cliente HTTP, por ejemplo, Voice, Sms, Verify
  • Añadir last_request y last_response al Cliente HTTP para facilitar la depuración
  • Migrado el paquete Vonage JWT al monorepo
  • Renombrado Verify -> Verify Legacy y Verify v2 -> Verify

3.17.4

30 de octubre de 2024

  • Elimina el soporte para Python 3.8, añade soporte para 3.13

3.17.3

30 de octubre de 2024

  • Corrección de un error en el generador de JWT

3.17.2

30 de octubre de 2024

  • Actualización vonage-jwt versión de dependencia para solucionar el problema del tiempo de espera de JWT

3.17.1

20 de agosto de 2024

  • Añade la opción "marcar mensaje de WhatsApp como leído" para Messages API

3.17.0

19 de agosto de 2024

  • Añadir opción de tipo de mensaje RCS para Messages API
  • Añadir la opción "revocar mensaje RCS

3.16.1

6 de agosto de 2024

  • Arreglar la opción de token de cliente de vídeo
  • Corrección de erratas en README
  • Aumento de las versiones mínimas de las dependencias con vulnerabilidades corregidas

3.16.0

7 de junio de 2024

3.15.0

3 de junio de 2024

3.14.0

13 de mayo de 2024

  • Añadir publisher-only como función válida del token de cliente de la Video API

3.13.1

30 de abril de 2024

  • Corregir serialización incorrecta de tipo de contenido

3.13.0

22 de diciembre de 2023

  • Migración para utilizar Pydantic V2 como dependencia

3.12.0

11 de diciembre de 2023

3.11.1

29 de noviembre de 2023

  • Añadir comprobaciones para parámetros opcionales de flujo de trabajo de autenticación silenciosa redirect_url y sandbox

3.11.0

19 de octubre de 2023

  • Añade un método para comprobar las firmas JWT de los webhooks de Voice API: vonage.Voice.verify_signature

3.10.0

4 de octubre de 2023

  • Indicando soporte para Python 3.12

3.9.1

30 de agosto de 2023

  • Actualización de la URL de la Meetings API a una /v1 punto final

3.9.0

21 de agosto de 2023

  • Se deja de dar soporte a Python 3.7 porque ha llegado al final de su vida útil y ya no recibe actualizaciones de seguridad.

3.8.0

14 de agosto de 2023

3.7.1

6 de julio de 2023

  • Fijar el rango de versiones de Pydantic en 1.x para evitar cambios de ruptura

3.7.0

22 de junio de 2023

  • Añadir soporte para el API de Meetings API de Vonage
  • Añadir soporte parcial para el API de Vonage Proactive Connect - métodos de la API relacionados con lists, items y events
  • Devolver un mensaje de error más descriptivo (no interno) si se proporcionan valores no válidos para application_id y/o private_key al instanciar un objeto cliente de Vonage

3.6.0

14 de junio de 2023

3.5.2

6 de junio de 2023

  • Utilización de la Generador JWT de Vonage en lugar de PyJWT para generar JWTs.
  • Otras mejoras y refactorizaciones internas

3.5.1

23 de mayo de 2023

  • Actualización del uso interno del fraud_check en la API Vonage Verify V2

3.5.0

16 de mayo de 2023

  • Incorporación de compatibilidad con la V2 de la API Verify de Vonage
    • Admite varios canales de autenticación (SMS, voz, correo electrónico, WhatsApp, mensajes interactivos de WhatsApp y autenticación silenciosa).
    • Ahora es posible utilizar canales alternativos en caso de que fallen los métodos de verificación.
    • Ahora puede personalizar el código de verificación que se envía, o incluso especificar su propio código personalizado
  • Añadir advancedMachineDetection funcionalidad del creador de NCCO para la Voice API de Vonage

3.4.0

14 Abr 2023

  • Cambios internos de refactorización
  • Uso de la autenticación de cabecera para la API de Numbers

3.3.0

3 mar 2023

  • API de Messages actualizada:
    • Añadidos nuevos canales de mensajería para los mensajes de servicio de Viber (video, file)
    • Añadido nuevo WhatsApp sticker canal de mensajes
    • Aumento de client_ref valor máximo hasta 100 caracteres
  • Obsoleto pay acción en el constructor NCCO como está siendo eliminado por Vonage

3.2.2

19 de enero de 2023

  • Corrección de un error en Windows

3.2.1

16 de enero de 2023

  • Corrección de un error de importación

3.2.0

14 de enero de 2023

  • Añadir un NCCO Builder para facilitar el trabajo con NCCOs cuando se utiliza la Voice API.
  • Las Acciones NCCO individuales pueden crearse como modelos Pydantic, que pueden incorporarse a una NCCO a través de la función Ncco.build_ncco método

4.0.0b0

2 de diciembre de 2022

  • No hay cambios funcionales con respecto a v3.2.0b0. Uso de un número de versión principal para mantener las versiones más sincronizadas cronológica y numéricamente.
  • Se trata de una versión beta que puede instalarse con pip install --pre vonage

3.2.0b0

11 de noviembre de 2022

  • Versión beta que incluye compatibilidad con Vonage Video API para sesiones, señalización, moderación y archivo
  • Esta rama se mantendrá separada de la base de código principal por ahora y se puede instalar con pip install --pre vonage

3.1.0

26 oct 2022

  • Compatible con Python 3.11
  • Actualización de algunas dependencias antiguas

3.0.2

25 oct 2022

  • Corrección de errores en messages.py donde el método de autenticación no se comprobaba correctamente, lanzando un error cuando se utilizaba header auth.

3.0.1

4 oct 2022

  • Se ha corregido un error por el que un JWT se creaba globalmente y podía caducar. Ahora se genera un nuevo JWT cuando se realiza una solicitud.
  • Se ha corregido un error por el que no se pasaba el tiempo de espera al objeto de sesión.

3.0.0

27 jul 2022

Cambios de última hora:

  • Se han eliminado los métodos obsoletos de client.py que ahora están disponibles en módulos específicos relacionados con cada una de las API de Vonage disponibles. Por ejemplo, para llamar a la Number Insight API, los métodos ahora se llaman de esta manera: client.number_insight.get_basic_number_insight(...)o instanciando el NumberInsight directamente: ni = vonage.NumberInsight(client), ni.get_basic_number_insight(...) etc.
  • Eliminada la creación automática de clientes al instanciar un sms, voice o verify objeto. Ahora puede utilizar estas API desde una instancia de cliente creada por usted (p. ej. client.sms.send_message()) o pasar un cliente a la clase API para crearlo (por ejemplo sms = vonage.Sms(client)), como ocurre desde la versión 2.7.0 del SDK.
  • Se eliminaron los métodos para llamar a la API de búsqueda de mensajes, que ha sido retirada por Vonage.
  • Se han eliminado los métodos obsoletos de percepción de voz y números de voice.py (initiate_call, initiate_tts_call and initiate_tts_prompt_call) y number_insight.py (request_number_insight).
  • Se ha cambiado el nombre del Account.delete_secret() para revoke_secret() para ajustarlo a lo descrito en nuestra documentación.

Depreciaciones:

  • Obsoleto el ApplicationV2 y hemos creado una clase Application con los mismos métodos para que la nomenclatura se ajuste a la de otras clases. Esto puede ser llamado desde el objeto cliente con client.application.create_application(...) etc. o directamente con application = vonage.Application(client), application.create_application(...) etc.
  • Métodos antiguos de la API de precios obsoletos get_sms_pricing y get_voice_pricing.
  • Clase Redactar obsoleta, ya que es un producto de la vista previa de desarrollo que no es compatible con el SDK y se eliminará en una versión posterior.

Mejoras:

  • Añadido get_all_countries_pricing para Account objeto.
  • Se ha añadido un type para las llamadas de tarificación, por lo que sms o voice ahora se puede elegir el precio.
  • Añadido max_retries, timeout, pool_connections y pool_maxsize argumentos de palabra clave opcionales para Client que ahora puede especificarse en la instanciación y utilizarse en las llamadas a la API realizadas con el cliente.

2.8.0

30 de junio de 2022

  • Se ha añadido compatibilidad con Messages API v1.0. Messages API puede utilizarse ahora llamando a la función client.messages.send_message() método.

2.7.0

26 de mayo de 2022

  • Se han trasladado algunos métodos de cliente a sus propias clases: account.py, application.py, message_search.py, number_insight.py, numbers.py, short_codes.py, ussd.py
  • Se han dejado obsoletos los métodos de cliente correspondientes. Se eliminarán en una versión mayor que se publicará próximamente.
  • Ahora el cliente crea una instancia de un objeto de clase para cada API cuando se crea, p. ej. vonage.Client(key="mykey", secret="mysecret") crea instancias de Account, Sms, NumberInsight etc. Estas instancias se pueden llamar ahora directamente desde Client.

2.6.4

27 Abr 2022

  • Eliminado el soporte para Python 3.6 e inferiores
  • Ahora soporta las versiones estables actuales de Python, es decir, Python 3.7-3.10
  • Refactorización y mejoras internas
  • Añadir por defecto max_retries a la opción BasicAuthenticationServer especificando parámetros opcionales

2.5.5

5 de enero de 2021

  • Problemas parcheados con PyJWT >1.8 (TypeError: can't concat str to bytes)
  • Este parche asegura que todas las versiones de PyJWT son compatibles.

2.5.3

14 de septiembre de 2020

  • Pequeños parches para reflejar los cambios en el espacio de nombres de Vonage

2.5.2

27 ago 2020

  • Compatibilidad con las API independientes de SMS, Voice y Verify con pruebas, así como con los métodos de cliente actuales.
  • Getters/Setters para extraer/reescribir atributos personalizados
  • Soporte de verificación PSD2
  • Adiós a Python 2.7
  • Hoja de ruta para mejorar la gestión de errores
  • Compatible con Python 3.8