API versioning and deprecation policy

The PetvitaClub public catalog API is free to use for read-only discovery and does not require registration, an API key, OAuth or a sales conversation. Version 1 is available under /api/v1. Product and guide responses may gain new optional fields without a version change. Existing fields will retain their documented meaning and type throughout the lifetime of v1.

Deprecation notice

An incompatible change requires a new URL version. If PetvitaClub retires an endpoint or API version, the affected responses will carry a standards-based Deprecation header and a Sunset header at least 90 days before removal. The response will also link to migration instructions. We will keep this page, the OpenAPI document and llms.txt aligned with the active public versions.

Limits and support

The public API currently enforces 120 requests per minute per client and route. Responses include RateLimit-Policy and RateLimit; a 429 response also includes Retry-After. Errors use RFC 9457 problem details with a machine-readable code and a suggested resolution. The API is for catalog and editorial discovery only: it does not expose checkout, payment, order creation, customer data or inventory mutation.