You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 53
Next »
Purpose
The purpose of this document is to list the high-level API endpoints required for headless commerce(B2C). This will helps in finalizing API design.
API Endpoints
Authentication
| Sr No. | API Endpoint | Description | Tasks | Status | Phase |
|---|
| 1 | POST /guest-token | This API will return a token for a guest account. |
| Planning | I |
| 2 | POST /customer-token | This API will return a token for the registered user. |
| Planning | I |
| 3 | POST /refresh-token | In case we need to update the token. As JWT token ideally contains a certain expiry time. So if the user is active then instead of getting him to log out, this API can generate a new token from the existing token. |
| Planning | I |
Customer
| Sr No. | API Endpoint | Description | Tasks/PRs | Status | Phase |
|---|
| Customer Profile |
| 1 | POST /customers | To register the customer. | https://github.com/apache/ofbiz-plugins/pull/45 | In Code Review | I |
| 2 | GET /customers/{customerPartyId} | To get the customer's personal information, addresses, emails, phones, etc. | https://github.com/apache/ofbiz-plugins/pull/45 | In Code Review | I |
| 3 | PUT /customers/{customerPartyId} | To update the customer's personal information. | https://github.com/apache/ofbiz-plugins/pull/45 | In Code Review | I |
| 4 | POST /customers/reset-password | To get the reset password link on the registered email. | https://github.com/apache/ofbiz-plugins/pull/45 | In Code Review | I |
| 5 | POST /customers/{customerPartyId}/change-password | To change the password. | https://github.com/apache/ofbiz-plugins/pull/45 | In Code Review | I |
| 6 | GET /customers/{customerPartyId}/shipping-addresses | To get the customer's shipping addresses | https://github.com/apache/ofbiz-plugins/pull/45 | In Code Review | I |
| 7 | POST /customers/{customerPartyId}/shipping-addresses | To create the shipping address. | https://github.com/apache/ofbiz-plugins/pull/45 | In Code Review | I |
| 8 | PUT /customers/{customerPartyId}/shipping-addresses/{contactMechId} | To update the shipping address. | https://github.com/apache/ofbiz-plugins/pull/45 | In Code Review | I |
| 9 | DELETE /customers/{customerPartyId}/shipping-addresses/{contactMechId} | To delete/expire the shipping address. | https://github.com/apache/ofbiz-plugins/pull/45 | In Code Review | I |
| 10 | POST /customers/{customerPartyId}/payment-methods | To save a payment method e.g. credit card, gift card, eft account | https://github.com/apache/ofbiz-plugins/pull/45 | In Code Review | I |
| 11 | GET /customers/{customerPartyId}/payment-methods | To get the user's payment methods eg. saved credit cards, gift cards, eft accounts | https://github.com/apache/ofbiz-plugins/pull/45 | In Code Review | I |
| 12 | PUT /customers/{customerPartyId}/payment-methods/{paymentMethodId} | To update the payment method detail. | https://github.com/apache/ofbiz-plugins/pull/45 | In Code Review | I |
| 13 | DELETE /customers/{customerPartyId}/payment-methods/{paymentMethodId} | To remove a saved credit card, gift card, eft account. | https://github.com/apache/ofbiz-plugins/pull/45 | In Code Review | I |
| 14 | GET /customers/{customerPartyId}/order-history | To fetch all the orders of a customer. |
| In Progress | I |
Catalog
| Sr No. | API Endpoint | Description | Tasks | Status | Phase |
|---|
| Catalog |
| 1 | GET /feature-product-categories | To get the featured products and categories specifically to show on home page. |
| Planning | I |
| 2 | GET /categories | To get the category hierarchy. |
| Planning | I |
| 3 | GET /categories/{categoryId} | This will fetch all the products of a category. |
|
|
|
| 4 | GET /products | This API will have support for the search string and other additional filters. This API will also bring the products of a selected category if provided. |
| Planning | I |
| 5 | GET /products/{productId} | To get the product detail. |
| Planning | I |
| 6 | POST /products/{productId}/reviews | To add a review of a product. |
| Planning | I |
| 7 | GET /offers | To list the special offers |
| Planning | I |
| Sr No. | API Endpoint | Description | Tasks | Status | Phase |
|---|
| Shopping List |
| 1 | POST /shopping-lists | To create a new shopping list. |
| Planning | I |
| 2 | GET /shopping-lists | To get the list of shopping lists. |
| Planning | I |
| 3 | GET /shopping-lists/{shoppingListId} | To get the detail of a shopping list. This will also bring the list of available interval/frequency data for setting the recurrence detail using the update shopping list API. |
| Planning | I |
| 4 | PUT /shopping-lists/{shoppingListId} | To update the shopping list detail. Recurrence info can also be set from this API. |
| Planning | I |
| 5 | POST /shopping-lists/{shoppingListId}/items | Add an item to the shopping list. |
| Planning | I |
| 6 | GET /shopping-lists/{shoppingListId}/items | Get the list of items on a shopping list. |
| Planning | I |
| 7 | PUT /shopping-lists/{shoppingListId}/items/{itemId} | Update the particular item on the shopping list. |
| Planning | I |
| 8 | DELETE /shopping-lists/{shoppingListId}/items/{itemId} | Remove the particular item from the shopping list. |
| Planning | I |
| Quote |
| 1 | POST /quote-requests | Quotes Request can be created from the shopping list and from the cart. This API will create a quote request. |
| Planning | I |
| 2 | GET /quote-requests | To get the list of quote requests(request history). |
| Planning | I |
| 3 | GET /quote-requests/{requestId} | To get the detail of a quote request. |
| Planning | I |
| 4 | GET /quotes | To get the list of quotes. |
| Planning | I |
| 5 | GET /quotes/{quoteId} | To get the detail of a quote. |
| Planning | I |
| 6 | POST /order-quotes | To create an order from the quote. |
| Planning | I |
Note: The below API endpoints are written considering the Object-Oriented implementation of Shopping Cart. We need to identify the best way to store the shopping cart object as the user session won't be in the picture here. One way to introduce a new table to keep the cart object with a unique cart ID. For better performance cache can also be used efficiently. The cart object should have the last updated timestamp so that a clear policy to remove the abandoned cart can be imposed.
| Sr No. | API Endpoint | Description | Tasks | Status | Phase |
|---|
| Shopping Cart |
| 1 | POST /carts |
|
| Planning | I |
| 2 | GET /carts/{cartReference} |
|
| Planning | I |
| 3 | DELETE /carts/{cartReference} |
|
| Planning | I |
| 4 | POST /carts/{cartReference}/items | For adding products and other order adjustments like shipping charges, tax, etc. |
| Planning | I |
| 5 | GET /carts/{cartReference}/items |
|
| Planning | I |
| 6 | PUT /carts/{cartReference}/items/{itemSeqId} |
|
| Planning | I |
| 7 | DELETE /carts/{cartReference}/items/{itemSeqId} |
|
| Planning | I |
| 8 | POST /carts/{cartReference}/promotions | To apply the promo code on the cart. |
| Planning | I |
| 9 | DELETE /carts/{cartReference}/promotions/{itemSeqId} | To remove an applied promotion. |
| Planning | I |
| 10 | POST /carts/{cartReference}/items/shopping-list/{shoppingListId} | This will add all the items of a given shopping list to the cart. |
| Planning | I |
| 11 | POST /carts/{cartReference}/items/order/{orderId} | This will add all the items of a given past order to the cart. |
| Planning | I |
| Checkout |
| 1 | POST /carts/{cartReference}/ship-groups | To create a new ship group in case of split shipment. |
| Planning | I |
| 2 | GET /carts/{cartReference}/ship-groups | To get the ship groups with items. |
| Planning | I |
| 3 | POST /carts/{cartReference}/ship-groups/{shipGroupSeqId}/shipping-address | To add the shipping address. |
| Planning | I |
| 4 | POST /carts/{cartReference}/ship-groups/{shipGroupSeqId}/items | To move items from one ship group to another in case of split shipment. |
| Planning | I |
| 5 | POST /carts/{cartReference}/ship-groups/{shipGroupSeqId}/shipping-instructions | To add special instructions, gift message in case of a gift, split preferences(ship all items together or ship items when available) |
| Planning | I |
| 6 | PUT /carts/{cartReference}/ship-groups/{shipGroupSeqId}/shipping-instructions | To update special instructions, gift message in case of a gift, split preferences(ship all items together or ship items when available) |
| Planning | I |
| 7 | GET /shipping-methods} | To get the shipping methods. |
| Planning | I |
| 8 | POST /carts/{cartReference}/ship-groups/{shipGroupSeqId}/shipping-method | To add/update the shipping method. |
| Planning | I |
| 9 | GET /payment-options | To get the list of supported payment options. |
| Planning | I |
| 10 | POST /carts/{cartReference}/payment-methods | To add a payment method. The combination of the gift card and other payment methods are supported as of now. |
| Planning | I |
| 11 | POST /checkout | To place the order. |
| Planning | I |
| Anonymous Checkout |
| 1 | POST /carts/{cartReference}/guest/personal-information | Set the anonymous user's detail for the order. Name, phone, email, etc. |
| Planning | I |
| 2 | PUT /carts/{cartReference}/guest/personal-information |
|
| Planning | I |
| 3 | POST /carts/{cartReference}/guest/shipping-address |
|
| Planning | I |
| 4 | PUT /carts/{cartReference}/guest/shipping-address |
|
| Planning | I |
| 5 | POST /carts/{cartReference}/guest/payment-informaion |
|
| Planning | I |
| 6 | PUT /carts/{cartReference}/guest/payment-informaion |
|
| Planning | I |
