Add resource pattern deprecation plan to README (#1592)

This commit is contained in:
helenye-stripe 2025-04-24 12:43:28 -07:00 committed by GitHub
parent 88c8720712
commit 1a0c78f112
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -127,6 +127,12 @@ Keep in mind that there are different method signatures depending on the action:
`retrieve(id, opts)`. In addition, it will accept a Hash for the `id` param but will extract the `retrieve(id, opts)`. In addition, it will accept a Hash for the `id` param but will extract the
`id` key out and use the others as options. `id` key out and use the others as options.
### StripeClient vs legacy pattern
We introduced the `StripeClient` class in v13 of the Ruby SDK. The legacy pattern used prior to that version is still available to use but will be marked as deprecated soon. Review the [migration guide to use StripeClient](https://github.com/stripe/stripe-ruby/wiki/Migration-guide-for-v13) to move from the legacy pattern.
Once the legacy pattern is deprecated, new API endpoints will only be accessible in the StripeClient. While there are no current plans to remove the legacy pattern for existing API endpoints, this may change in the future.
### Accessing resource properties ### Accessing resource properties
Both indexer and accessors can be used to retrieve values of resource properties. Both indexer and accessors can be used to retrieve values of resource properties.