Appearance
API Overview
WedoCOD exposes two API surfaces:
| Surface | Base URL | Auth | Purpose |
|---|---|---|---|
| REST API | api/web/1.0/ | Sanctum Bearer Token | External integrations — bulk create/read/delete leads & orders |
| Dashboard | / | Session (Cookie) | Dashboard UI operations — products, stocks, users, settings, etc. |
REST API (v1.0)
The REST API is the primary integration point for external systems (Shopify, WooCommerce, custom storefronts). It uses Laravel Sanctum bearer token authentication.
Available resources:
| Resource | Endpoints | Description |
|---|---|---|
| Leads | Create, List, Show, Delete, Update | Bulk create up to 1,000 leads per request |
| Orders | Create, List, Show, Delete, Update | Bulk create up to 1,000 orders per request |
| Lead Histories | List | Read lead status change history |
| Order Histories | List | Read order status change history |
Base URL
https://{your-domain}/api/web/1.0/Request Format
- Content-Type:
application/json - All requests must include a valid
Authorization: Bearer {token}header - Bulk endpoints accept arrays in the request body
Response Format
All responses return JSON. Successful responses include the resource data. Error responses follow a standard structure — see Error Handling.
Dashboard API
The dashboard routes power the WedoCOD web interface. These are session-authenticated and used by Admin and Seller roles within the platform.
Dashboard operations are organized by resource:
| Resource | Roles | Description |
|---|---|---|
| Products | Admin, Seller | Product catalog management |
| Stocks | Admin, Seller | Inventory levels per warehouse |
| Warehouses | Admin | Warehouse CRUD |
| Marketplace | Admin, Seller | Marketplace products and affiliate requests |
| Shipping Companies | Admin | Courier integrations |
| Invoices & Finance | Admin, Seller | Payment requests and invoice management |
| Sourcings | Admin, Seller | Product sourcing requests with chat |
| Statistics | Admin, Seller | Leads, orders, agents, product analytics |
| Users | Admin | Manage all user roles |
| Applications | Seller | Google Sheets, YouCan, LightFunnels integrations |
| Settings | Admin, Seller | API keys, webhooks, profile, payments |
| Webhooks | Admin, Seller | Incoming webhook configuration for e-commerce platforms |
Permissions
Every endpoint enforces role-based access control. See the full Permissions Matrix for a complete breakdown of what each role can access.
API Versioning
The current API version is v1.0. The version is included in the REST API URL path (api/web/1.0/). Dashboard routes are unversioned.