API Documentation

Quick Links

Overview Authentication Endpoints

Overview

Welcome to the API documentation for our service. This RESTful API allows you to interact with our platform programmatically.

All API endpoints return JSON responses and require authentication via API keys.

Base URL: https://shopacct.com/api/v1

Authentication

To authenticate your requests, include your API key in the Authorization header.

Authorization: Bearer <token>
Accept: application/json

Keep your API keys secure and never expose them in client-side code.

Endpoints

GET /products

Retrieve a list of all available products.

Example Request

curl --location -g 'https://shopacct.com/api/v1/products' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Example Response

{
    "data": [
        {
            "id": 1,
            "name": "Facebook Account",
            "price": "10.00",
            "in_stock": 100
        },
        {
            "id": 2,
            "name": "Instagram Account",
            "price": "12.00",
            "in_stock": 50
        }
    ]
}

GET /categories

Retrieve a list of all product categories.

Example Request

curl --location -g 'https://shopacct.com/api/v1/categories' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Example Response

{
    "data": [
        {
            "id": 1,
            "name": "Social Media"
        },
        {
            "id": 2,
            "name": "Email Accounts"
        }
    ]
}

GET /categories/{id}/products

Retrieve all products within a specific category.

Example Request

curl --location -g 'https://shopacct.com/api/v1/categories/1/products' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Example Response

{
    "data": [
        {
            "id": 1,
            "name": "Facebook Account",
            "price": "10.00",
            "in_stock": 100
        }
    ]
}

GET /balance

Retrieve the user's current wallet balance.

Example Request

curl --location -g 'https://shopacct.com/api/v1/wallet-balance' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Example Response

{
    "balance": "99.99"
}

GET /products/{id}

Retrieve details for a specific product.

Example Request

curl --location -g 'https://shopacct.com/api/v1/products/1' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Example Response

{
    "data": {
        "id": 1,
        "name": "Facebook Account",
        "price": "10.00",
        "in_stock": 100,
        "description": "A high-quality Facebook account."
    }
}

GET /products/{id}/details

Retrieve available stock details for a specific product.

Example Request

curl --location -g 'https://shopacct.com/api/v1/products/1/details' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Example Response

{
    "data": [
        {
            "id": 123,
            "details": "user:pass"
        },
        {
            "id": 124,
            "details": "user2:pass2"
        }
    ]
}

POST /order

Place an order for one or more product details. Provide an array of `product_details_ids`.

Example Request

curl --location 'https://shopacct.com/api/v1/order' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "product_details_ids": [123, 124]
}'

Example Response

{
    "message": "Order placed successfully!",
    "order_id": 5,
    "total_cost": "20.00"
}