Queremos que os criadores alcancem assinaturas no mundo todo. Por isso, em breve os patronos vão poder pagar em qualquer moeda aceita e não apenas na escolhida pelo criador. Confira abaixo as atualizações de documentação para APIv1 e APIv2. Se quiser saber mais sobre as moedas aceitas pelo Patreon, leia este artigo na Central de Ajuda: Moedas aceitas pelo Patreon
APIv1
Para garantir uma transição perfeita para os desenvolvedores usando a API do Patreon, estamos melhorando a documentação do atributo
currency na APIv1 que retorna a moeda de contribuição do patrono. O atributo currency na APIv1 é retornado no recurso contribuição de forma padrão. Por exemplo, os desenvolvedores que usam a APIv1 encontram a currency: GBP em um recurso de contribuição em que o patrono paga £ 5 (GBP é o código de moeda ISO para a libra esterlina), junto com os atributos de contribuição existentes, como amount_cents: 500 e mais.O recurso registro da contribuição da APIv2 já mostra o
currency_code que é equivalente a currency da APIv1. Além das atualizações de documentação da API, estamos mostrando um atributo de
status no recurso de contribuição da APIv1. Desenvolvedores que usam a APIv1 para restringir e/ou conceder acesso a benefícios agora podem verificar se o atributo status é valid (ou seja, status: valid) e fazer referência à relação de recompensa (modalidade) para saber se um patrono conseguiu contribuir com uma modalidade, independentemente da moeda do patrono ou do criador. Com esta abordagem, não é necessário comparar o valor da contribuição do patrono com o valor devido em uma modalidade, evitando sobrecarga na gestão das taxas de câmbio. Na prática, suas solicitações na APIv1 serão semelhantes ao exemplo abaixo:
respondendo com:
A resposta inclui a relação de
reward (modalidade do criador). O status é um campo opcional que precisa ser solicitado explicitamente. Note também que os atributos predeterminados não são retornados se você solicitar os campos explicitamente.
APIv2
Para administrar o acesso aos benefícios usando a APIv2, recomendamos que os desenvolvedores usem o recurso Membro. Os desenvolvedores podem verificar o
patron_status e a currently_entitled_tiers para restringir ou conceder acesso a benefícios por modalidade, independentemente da moeda. Para acessar esses atributos, sua solicitação APIv2 é preenchida da seguinte forma:
e resulta em uma resposta semelhante ao que é mostrado abaixo:
Modalidades excluídas não são retornadas na relação
currently_entitled_tiers . Desenvolvedores usando a APIv2 que precisam acessar as modalidades excluídas podem fazer referência ao PledgeEvent para administrar o acesso aos benefícios. Não há nada equivalente à APIv1, então os desenvolvedores devem trocar de API se o acesso à informação das contribuições excluídas for essencial.Resumindo: se você usar
amount_cents nos recursos Membro,Registro de contribuição ou Contribuição , o valor retornado estará sempre na moeda do patrono e não na moeda da modalidade da recompensa ou da campanha. As atualizações das APIv1 e APIv2 acima permitem que os desenvolvedores concedam o acesso aos benefícios sem se preocupar com as diferenças de moeda entre patrono e criador. Se você precisar de ajuda para aproveitar ao máximo essas atualizações, acesse docs.patreon.com.