Skip to content

Conversation

@gustaavik
Copy link
Member

This pull request updates the documentation for several API systems in the Commercify platform, including the addition of new endpoint summaries, response formats, and example usage. The changes aim to enhance clarity, usability, and consistency across the documentation.

API Documentation Enhancements:

Comprehensive API Endpoint Summary:

  • Added a detailed summary of all API endpoints, categorized by functionality (e.g., public, authenticated, admin). Includes endpoint descriptions, request methods, and expected status codes in docs/API_ENDPOINTS_SUMMARY.md.

Category API Examples:

  • Added example request bodies and responses for public and admin category endpoints in docs/category_api_examples.md. This includes endpoints for listing categories, retrieving child categories, and admin operations like creating, updating, and deleting categories.

Checkout API Updates:

  • Standardized response format across all checkout API endpoints, ensuring consistency with other APIs. Updated response examples to include the success field and other standardized properties in docs/checkout_api_examples.md. [1] [2] [3]

Removed Outdated Documentation:

Payment Provider System:

  • Removed the outdated docs/PAYMENT_PROVIDER_SYSTEM.md, which described the previous implementation of the PaymentProviderRepository system. The new centralized management approach is already reflected in other parts of the documentation.

Database Setup Guide:

  • Removed docs/DATABASE_SETUP.md, which detailed database configuration steps for SQLite and PostgreSQL. This guide has been deprecated in favor of environment-specific setup instructions provided elsewhere.

gustaavik added 4 commits July 7, 2025 23:30
…bhook endpoints

- Enhanced payment API examples with detailed request and response structures.
- Added admin payment management endpoints including capture, cancel, and refund functionalities.
- Updated product API examples to reflect admin-only access and improved request/response formats.
- Expanded shipping API documentation with new methods for creating shipping zones and rates.
- Revised user API examples to align with authentication changes.
- Introduced a new webhook API documentation outlining Stripe and MobilePay webhook handling.
@gustaavik gustaavik merged commit feaec24 into main Jul 8, 2025
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants