Shop Management - Wolfix.Server

Get Seller Profile (Seller)

Retrieves complete profile information for a seller.

Path Parameters

sellerId

string (uuid)

required

Seller identifier (must match authenticated seller)

Response

string (uuid)

Seller identifier

shopName

string

Shop name

shopDescription

string

Shop description

string

Seller email address

firstName

string

Seller first name

lastName

string

Seller last name

phoneNumber

string

Seller contact phone

address

object

Business address

averageRating

number

Average seller rating

totalSales

integer

Total number of sales

Response Codes

200 OK - Profile retrieved
404 Not Found - Seller not found

Example

cURL

curl -X GET "https://your-server.com/api/sellers/seller-uuid" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Success Response

{
  "id": "seller-uuid",
  "shopName": "AudioPro Electronics",
  "shopDescription": "Premium audio equipment and accessories",
  "email": "[email protected]",
  "firstName": "John",
  "lastName": "Smith",
  "phoneNumber": "+1-555-123-4567",
  "address": {
    "street": "123 Business Ave",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001",
    "country": "USA"
  },
  "averageRating": 4.8,
  "totalSales": 1247,
  "createdAt": "2024-01-01T10:00:00Z"
}

Get Seller Categories (Seller)

Retrieves all product categories used by the seller’s products.

Path Parameters

sellerId

string (uuid)

required

Seller identifier

Response

Response Codes

200 OK - Categories retrieved
404 Not Found - Seller not found

Example

cURL

curl -X GET "https://your-server.com/api/sellers/seller-uuid/categories" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Success Response

[
  {
    "categoryId": "category-uuid-1",
    "categoryName": "Headphones",
    "parentCategoryName": "Audio",
    "productCount": 45
  },
  {
    "categoryId": "category-uuid-2",
    "categoryName": "Speakers",
    "parentCategoryName": "Audio",
    "productCount": 23
  }
]

Update Full Name (Seller)

Updates seller’s first and last name.

Path Parameters

sellerId

string (uuid)

required

Seller identifier

Request Body

firstName

string

required

New first name

lastName

string

required

New last name

Response Codes

200 OK - Name updated
400 Bad Request - Invalid name
404 Not Found - Seller not found

Example

cURL

curl -X PATCH "https://your-server.com/api/sellers/seller-uuid/full-name" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Jane",
    "lastName": "Doe"
  }'

Update Phone Number (Seller)

Updates seller’s contact phone number.

Request Body

phoneNumber

string

required

New phone number

Example

cURL

curl -X PATCH "https://your-server.com/api/sellers/seller-uuid/phone-number" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumber": "+1-555-987-6543"}'

Update Address (Seller)

Updates seller’s business address.

Request Body

street

string

required

Street address

city

string

required

City

state

string

required

State/Province

zipCode

string

required

ZIP/Postal code

country

string

required

Country

Example

cURL

curl -X PATCH "https://your-server.com/api/sellers/seller-uuid/address" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "street": "456 Commerce Blvd",
    "city": "San Francisco",
    "state": "CA",
    "zipCode": "94102",
    "country": "USA"
  }'

Update Birth Date (Seller)

Updates seller’s date of birth.

Request Body

birthDate

string (date)

required

Date of birth (format: YYYY-MM-DD)

Example

cURL

curl -X PATCH "https://your-server.com/api/sellers/seller-uuid/birth-date" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"birthDate": "1980-03-25"}'

Get All Sellers (SuperAdmin)

Retrieves paginated list of all sellers (admin use only).

Path Parameters

page

integer

required

Page number (starts at 1)

Query Parameters

pageSize

integer

default:"50"

Items per page

Example

cURL

curl -X GET "https://your-server.com/api/sellers/page/1?pageSize=50" \
  -H "Authorization: Bearer YOUR_ADMIN_JWT_TOKEN"

Delete Seller (SuperAdmin)

Deletes a seller account and associated data.

Path Parameters

sellerId

string (uuid)

required

Seller identifier

Response Codes

204 No Content - Seller deleted
400 Bad Request - Seller has active orders or other dependencies
404 Not Found - Seller not found
500 Internal Server Error - Error during deletion

Example

cURL

curl -X DELETE "https://your-server.com/api/sellers/seller-uuid" \
  -H "Authorization: Bearer YOUR_ADMIN_JWT_TOKEN"

Deleting a seller may affect active orders and product listings. Ensure proper cleanup before deletion.

Shop Management Best Practices

Profile Completeness

Complete all profile information to build trust with customers. Include:

Professional shop name
Detailed description
Valid contact information
Accurate business address

Shop Performance Metrics

Monitor key metrics:

Average Rating: Customer satisfaction rating
Total Sales: Number of completed orders
Response Time: How quickly you respond to inquiries
Fulfillment Rate: Percentage of orders successfully fulfilled

Maintaining Good Standing

Update Information

Keep contact and address information current

Respond Quickly

Answer customer inquiries promptly

Fulfill Orders

Process and ship orders within promised timeframes

Maintain Quality

Ensure product quality matches descriptions

Handle Issues

Address customer complaints professionally

Overview

Identity

Catalog

Order

Customer

Seller

Media

Support

Admin

​Get Seller Profile (Seller)

​Path Parameters

​Response

​Response Codes

​Example

​Success Response

​Get Seller Categories (Seller)

​Path Parameters

​Response

​Response Codes

​Example

​Success Response

​Update Full Name (Seller)

​Path Parameters

​Request Body

​Response Codes

​Example

​Update Phone Number (Seller)

​Request Body

​Example

​Update Address (Seller)

​Request Body

​Example

​Update Birth Date (Seller)

​Request Body

​Example

​Get All Sellers (SuperAdmin)

​Path Parameters

​Query Parameters

​Example

​Delete Seller (SuperAdmin)

​Path Parameters

​Response Codes

​Example

​Shop Management Best Practices

​Profile Completeness

​Shop Performance Metrics

​Maintaining Good Standing

Build docs developers (and LLMs) love

Get Seller Profile (Seller)

Path Parameters

Response

Response Codes

Example

Success Response

Get Seller Categories (Seller)

Path Parameters

Response

Response Codes

Example

Success Response

Update Full Name (Seller)

Path Parameters

Request Body

Response Codes

Example

Update Phone Number (Seller)

Request Body

Example

Update Address (Seller)

Request Body

Example

Update Birth Date (Seller)

Request Body

Example

Get All Sellers (SuperAdmin)

Path Parameters

Query Parameters

Example

Delete Seller (SuperAdmin)

Path Parameters

Response Codes

Example

Shop Management Best Practices

Profile Completeness

Shop Performance Metrics

Maintaining Good Standing