안녕하세요 여러분
Patreon Discourse 플러그인 은 현재 몇 년 전부터 비추천(deprecated)된 Patreon API v1 을 사용하고 있습니다. 통합 기능이 정상적으로 작동하도록 유지하려면 API v2로 업데이트가 필요합니다.
Patreon의 API v2 는 공식적으로 지원되는 버전으로, v1과 동등한 기능을 제공하며 더 일관된 데이터 모델과 개선된 리소스 관계를 갖추고 있습니다.
문서:
주요 마이그레이션 사항:
현재 /api/oauth2/를 사용하는 일부 API 호출은 v2 엔드포인트로 업데이트해야 합니다.
플러그인 사용자는 마이그레이션 과정에서 v2 스코프를 가진 새로운 Patreon OAuth 클라이언트를 생성해야 합니다. v1 클라이언트는 호환되지 않습니다.
데이터 구조(예: campaign, member, pledge)는 v2에서 다르게 모델링되어 있습니다.
이러한 유형의 업데이트에 대한 프로세스가 어떻게 되는지 알고 싶습니다. 이번 마이그레이션에 대한 가이드 제공에 기꺼이 도움을 드리겠습니다.
이 통합 기능을 유지해 주셔서 감사합니다
2개의 좋아요
이 주제에 대해 후속 질문을 드리고자 합니다. 이 플러그인이 여전히 적극적으로 유지보수되고 있습니까, 아니면 비활성 상태라고 가정하고 v1 API의 종료로 인해 플러그인이 더 이상 작동하지 않는다는 점을 받아들여야 합니까?
1개의 좋아요
네. 공식 플러그인이고 코어에 포함되었으며, 마지막 커밋이 불과 지난 주에 이루어졌으므로 아직까지도 능동적으로 유지 관리되고 있다고 생각합니다.
1개의 좋아요
Falco
(Falco)
11월 22, 2025, 3:30오후
4
마지막으로 이 문제를 조사했을 때, Patreon은 API v2를 담당하던 팀을 중간에 해체했기 때문에 API v1은 무기한으로 작동할 것이라고 했습니다.
반대되는 내용을 담은 자료를 링크해 주실 수 있을까요?
1개의 좋아요
다시 한번 답변해 주셔서 감사합니다! 이 부분에 대한 출처를 말씀드리면, 저는 Patreon 팀의 엔지니어입니다. 저희 공개 문서 와 클라이언트 생성 플로우에는 v1 비(非)추천(deprecation)에 대한 안내가 포함되어 있습니다. V2는 이미 5년 이상 주요 API로 사용되어 왔으며, Discourse는 여전히 V2를 사용하지 않는为数不多的 몇 안 되는 통합 서비스 중 하나입니다.
수정: 추가 정보가 필요하시면 DM이나 이메일(혹시 Discourse 알림을 받지 못할 수 있으니)로 연락해 주세요.
6개의 좋아요
안녕하세요 @Falco , 플러그인 업데이트에 대한 최신 정보나 계획이 있나요? v1 종료의 영향을 최소화하고 싶습니다. 감사합니다.
3개의 좋아요
Falco
(Falco)
3월 21, 2026, 2:20오전
7
다음 주에 업데이트를 시도해 보겠습니다. 테스트 자격 증명을 받을 수 있을까요?
4개의 좋아요
정말 멋진 정보네요, @falco님 ! 감사드립니다! Patreon에는 공개된 테스트 사용자는 없습니다. 이 기능을 테스트하는 가장 좋은 방법은 다음과 같습니다:
테스트 계정을 생성하고(https://www.patreon.com/login ) 이메일 인증을 완료하세요.
크리에이터만 OAuth 클라이언트를 생성할 수 있습니다. https://patreon.com/create 에 접속하여 크리에이터 캠페인을 시작해야 합니다(캠페인 시작을 위해 이메일 인증이 필요합니다).
테스트 티어를 생성하세요: https://patreon.com/c/yourvanity/membership .
이제 https://www.patreon.com/portal/registration/register-clients 에서 v2 API 클라이언트를 생성할 수 있습니다.
액세스 게이팅/멤버십 기능을 테스트하려면 별도의 테스트 계정을 만들어야 합니다. 이후 테스트 캠페인의 무료 티어에 후원(pledge)하거나, 크리에이터가 선물 멤버십을 부여하는 방식을 사용할 수 있습니다.
다음 주에 페어 프로그래밍이나 DM을 통해 도움을 드릴 수 있습니다. 응답해 주셔서 감사합니다.
1개의 좋아요
Falco
(Falco)
3월 26, 2026, 5:02오후
9
무엇을 시도해도 제출 버튼이 활성화되지 않습니다.
아래에서 보고된 것과 동일한 문제입니다.
Hello, I am trying to create a new OAuth v2 client for my Patreon creator page, but the “Create Client” button stays disabled and cannot be clicked. I have: a published creator page with paying members the correct redirect URI all required...
Reading time: 1 min 🕑
Likes: 2 ❤
이것이 변경 사항을 병합하는 것을 막는 유일한 장애물입니다.
main ← patreon-api-v2-migration
merged 05:43PM - 30 Mar 26 UTC
## Summary
Patreon API v1 has been deprecated for years and the Patreon team ha… s requested we migrate to v2 (see https://meta.discourse.org/t/upgrade-patreon-discourse-plugin-to-api-v2/386701).
Since hundreds of existing customers have v1 OAuth clients, this PR supports **both versions simultaneously** via an adapter pattern, controlled by a new `patreon_api_version` site setting (defaults to `"1"` so no one breaks on upgrade).
### What changed
- **Adapter pattern**: `Patreon::ApiVersion::V1` and `ApiVersion::V2` modules with identical interfaces for endpoints, response parsing, and OAuth config. `ApiVersion.current` routes based on the site setting.
- **v2 API support**: campaigns endpoint returns tiers (not rewards), members fetched separately with cursor-based pagination, v2 identity endpoint with explicit field selection, v2 OAuth scopes
- **Webhooks accept both formats**: payload version detected from `data.type` (`"pledge"` → v1, `"member"` → v2), regardless of the site setting
- **Admin deprecation notice**: `ProblemCheck::PatreonApiV1Deprecated` warns on the dashboard when still using v1
- **Shared logic unchanged**: rate limiting, PluginStore, group sync, admin UI all version-agnostic
- Also fixes pre-existing flaky seed/campaign spec failures
### Migration path for existing users
1. Admin sees deprecation warning on dashboard
2. Create a new v2 OAuth client at https://www.patreon.com/portal/registration/register-clients
3. Update credentials in site settings
4. Switch `patreon_api_version` to `"2"`
5. Creator re-authenticates via Patreon login to get v2-scoped tokens
6. Trigger a manual data sync from the Patreon admin panel
### Future v1 removal
When ready to drop v1: delete `lib/api_version/v1.rb`, the problem check, the site setting, v1 fixtures, and v1 test contexts — one clean cut.
## Test plan
- [x] All 41 plugin specs pass (both v1 and v2 contexts)
- [x] Lint passes on all changed files
- [x] Zeitwerk reload passes (`bin/rails runner "Rails.application.reloader.reload!"`)
- [ ] Manual testing with a real Patreon v2 OAuth client
5개의 좋아요
@Falco 오늘早些时候我们发布了针对此问题的修复,非常抱歉!您可以再试一次吗?另外,进展真快!
2개의 좋아요
Falco
(Falco)
3월 27, 2026, 3:29오후
11
네, 테스트 사이트에서 잘 작동하고 있습니다. 월요일 초에 변경 사항을 병합하겠습니다.
3개의 좋아요
빨리 처리해 주셔서 감사합니다!
v2 업그레이드와는 무관하지만, 이 PR을 작성하시는 중에 한 가지 부탁드릴 게 있습니다. 사용자 에이전트를 커스텀 값으로 설정해 주실 수 있을까요? 예를 들어 Discourse-Patreon-Plugin/vX.x 같은 형태로요. 그러면 나중에 API 문제를 디버깅하고 클라이언트를 식별하는 데 도움이 될 것입니다. v1 비추천 조치와 관련하여 Faraday UA를 여러 개 확인했는데, 그 덕분에 Discourse가 여전히 v1을 사용하는 앱 중 하나라는 것을 알게 되었습니다.
3개의 좋아요