Customer API Quick Start: Integrate Accplanet /api/v2 in One Loop

If you buy on Accplanet programmatically, you do not need a different API for every action. The Customer API uses one endpoint — POST https://accplanet.com/api/v2 — and an action parameter. This guide is a practical quick start so a developer can list catalog items, check stock, place an order, and poll status in one sitting.

Accplanet is a supplier aggregation marketplace. Suppliers fulfill inventory; Accplanet provides discovery, checkout, order tracking, and support. Use the API for legitimate order management only. Full reference: Customer API docs.

Auth and endpoint

Create or copy your customer API key from your Accplanet profile API key page, then call:

POST https://accplanet.com/api/v2

{
  "key": "YOUR_API_KEY",
  "action": "categories"
}

Supported actions: categories, shops, services, inventory, add, status, balance.

Integration ladder

Stop when each step returns a clean response before moving on.

Copy-paste curl recipes

# Balance
curl -X POST https://accplanet.com/api/v2 -d "key=YOUR_API_KEY" -d "action=balance"

# Services page
curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" -d "action=services" -d "page=1" -d "limit=50"

# Inventory
curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" -d "action=inventory" -d "service=10042"

# Add order
curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" -d "action=add" -d "service=10042" -d "quantity=1"

# Status
curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" -d "action=status" -d "order=YOUR_ORDER_ID"

Replace placeholders with your key, a real service from services, and the order returned by add. Start with quantity 1 on a low-cost test item.

Errors and rate limits

• Invalid credentials → HTTP 401 with {"error":"Invalid API key"}.
• Validation / stock / balance issues → usually HTTP 400 with a single error string (e.g. insufficient stock or balance).
• Rate limit → HTTP 429 with Retry-After. Back off and retry.
• Default services page size is 50 when paginating; use limit=0 only when you intentionally want the full list.

Pricing, stock, and availability change with live listings. Always re-read services / inventory before automated buys.

Buyer checklist

• [ ] API key stored in a server secret manager
• [ ] balance OK for a small test order
• [ ] Picked a service with available=true
• [ ] Quantity within min/max
• [ ] Persisted order ID from add and poll status
• [ ] Handled 429 and wallet errors in code

Next step: open the Customer API documentation, run Test API once, then wire the same actions into your backend. Suppliers integrating catalog sync should read the companion supplier guide on Accplanet’s blog.

FAQ