Skip to content

Conversation

@gustaavik
Copy link
Member

This pull request introduces new API documentation for the discount and payment systems, refines shipping workflows, and expands the readme.md to include additional endpoints and workflows. The changes aim to improve clarity, usability, and completeness of the API documentation.

New API Documentation:

  • docs/discount_api_examples.md: Added detailed examples for public and admin discount endpoints, including workflows for creating, applying, and managing discounts.
  • docs/payment_api_examples.md: Added comprehensive examples for public, user, and admin payment endpoints, including workflows for processing payments and handling webhooks.

Refinements to Shipping Documentation:

  • docs/shipping_api_examples.md: Revised the shipping configuration and customer selection workflows to improve clarity and separate admin and customer flows.

Updates to readme.md:

  • Expanded endpoints:

    • Added admin-specific endpoints for user management (e.g., listing users, updating roles, activating/deactivating users).
    • Enhanced cart-related endpoints to distinguish between guest and authenticated user workflows.
    • Added endpoints for managing discounts, payments, and shipping (e.g., applying discounts, capturing payments, creating shipping methods). [1] [2]
  • Key workflows:

    • Documented key e-commerce workflows such as user management, product management, shopping experience, checkout process, order management, and admin functions.

gustaavik added 3 commits May 3, 2025 13:46
- Created detailed examples for Payment API including public, processing, admin management, and webhook endpoints.
- Added examples for Product API covering public, seller-specific, and variant management endpoints.
- Included user management API examples for public registration, login, profile management, and admin user management.
@gustaavik gustaavik requested a review from Copilot May 3, 2025 11:50
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This pull request enhances the API documentation by adding detailed examples and workflows for discount, payment, and shipping systems while also expanding the readme to include additional endpoints.

  • New discount API documentation including example requests and responses
  • Expanded payment API examples with detailed flows for credit card, PayPal, and MobilePay
  • Updated shipping documentation with clear admin and customer configuration flows and extended readme endpoints

Reviewed Changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

File Description
readme.md Expanded endpoints for admin and improved e-commerce workflow descriptions, though some endpoints appear in more than one section.
docs/shipping_api_examples.md Updated shipping configuration and customer selection flows.
docs/payment_api_examples.md Added comprehensive examples and detailed payment workflows.
docs/discount_api_examples.md Introduced detailed examples for applying, updating, and deleting discounts.

gustaavik and others added 2 commits May 3, 2025 13:56
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@gustaavik gustaavik merged commit b3e862b into development May 3, 2025
@gustaavik gustaavik deleted the add-api-docs branch May 3, 2025 12:00
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