¡Buenas noticias! Para ayudar a los creadores a aumentar sus suscripciones a nivel mundial, los mecenas pronto tendrán la posibilidad de pagar en cualquiera de las monedas que admitimos independientemente de cuál sea la que elijan los creadores. A continuación, encontrarás los cambios que hemos incluido en la documentación de la APIv1 y la APIv2. Para obtener más información sobre las monedas admitidas, consulta este artículo del Centro de ayuda: Monedas admitidas por Patreon
APIv1
Para que los desarrolladores que utilizan la API de Patreon experimenten una transición lo más fluida posible, estamos mejorando la documentación del atributo
currency en la APIv1, que devuelve la moneda que ha elegido el mecenas para hacer su aportación. Ten en cuenta que el atributo currency en la APIv1 se devuelve en el recurso Pledge por defecto. Por ejemplo, los desarrolladores que utilicen la APIv1 verán currency: GBP en un recurso Pledge para un mecenas que pague 5 £ (en el que GBP es el código ISO de la libra esterlina), junto con los atributos de la aportación que ya existen, como amount_cents: 500 , entre otros.Ten en cuenta que el recurso PledgeEvent en la APIv2 ya muestra
currency_code , que es el mismo atributo que currency en la APIv1. Además de las actualizaciones en la documentación de la API, vamos a mostrar un atributo de
status ante el recurso Pledge de la APIv1. Ahora, los desarrolladores que utilicen la APIv1 para restringir o conceder acceso a las ventajas pueden comprobar si el atributo status es válido (es decir, status: valid) y consultar la relación con reward (nivel) para saber si un mecenas se ha suscrito correctamente a un nivel, independientemente de la moneda del creador y del mecenas. De esta forma se evita la necesidad de comparar los importes de las aportaciones de los mecenas con el importe adeudado en un nivel y, por lo tanto, se evitan los gastos derivados de la gestión de los tipos de cambio de moneda. En la práctica, tus solicitudes a la APIv1 tendrán un aspecto similar a este:
que devuelve:
La respuesta incluye la relación de
reward (nivel de creador). Recuerda que status es un campo opcional que necesitas solicitar explícitamente. También recuerda que los atributos predeterminados no se devuelven si solicitas campos explícitamente.
APIv2
Para acceder a las ventajas a través de la APIv2, recomendamos a los desarrolladores que utilicen el recurso Member. Los desarrolladores pueden usar
patron_status y currently_entitled_tiers para restringir o conceder acceso a las ventajas por nivel, independientemente de la moneda. Para acceder a estos atributos, tu solicitud a la APIv2 aparecerá de la siguiente manera:
y devolverá algo parecido a lo que mostramos a continuación:
Ten en cuenta que los niveles eliminados no se devuelven en la relación
currently_entitled_tiers . Los desarrolladores de la APIv2 que necesiten acceder a mecenas con niveles eliminados pueden usar PledgeEvent para conceder acceso a las ventajas. No hay un equivalente en la APIv1, por lo que los desarrolladores deben actualizar a la siguiente versión si el acceso a la información de los niveles eliminados es importante.En resumen, si usas
amount_cents en los recursos Member,PledgeEvent o Pledge , el valor que se devuelve siempre se muestra en la moneda del mecenas, no en la moneda del nivel de recompensa o campaña. Las actualizaciones anteriores dan a los desarrolladores de la APIv1 y la APIv2 la capacidad de conceder acceso a las ventajas del creador sin tener que preocuparse por las diferencias de moneda entre el mecenas y el creador. Si necesitas ayuda para aprovechar al máximo estas últimas actualizaciones, te invitamos a entrar en docs.patreon.com.