sync-basalam / includes / Config / Endpoints.php

Endpoints.php in ووسلام – همگام سازی ووکامرس و باسلام 1.10.2, at includes/Config/Endpoints.php

148 lines 5.5 KB

Raw Download Zip

1	<?php
2
3	namespace SyncBasalam\Config;
4
5	defined('ABSPATH') \|\| exit;
6
7	final class Endpoints
8	{
9	// Base hosts
10	const OPENAPI_BASE = 'https://openapi.basalam.com';
11	const ORDER_BASE = 'https://order-processing.basalam.com';
12	const CORE_BASE = 'https://core.basalam.com';
13	const UPLOAD_BASE = 'https://uploadio.basalam.com';
14	const CATEGORY_BASE = 'https://categorydetection.basalam.com';
15	const APPS_BASE = 'https://apps-api.basalam.com';
16	const HAMSALAM_BASE = 'https://api.hamsalam.ir/api/v1';
17	const BASALAM_ACCOUNTS = 'https://basalam.com/accounts/sso';
18
19	// Products
20
21	/** GET all categories */
22	const CATEGORIES = self::OPENAPI_BASE . '/v1/categories';
23
24	/** GET category attributes — sprintf($url, $categoryId) */
25	const CATEGORY_ATTRIBUTES = self::OPENAPI_BASE . '/v1/categories/%d/attributes?exclude_multi_selects=true';
26
27	/** POST create product for a vendor — sprintf($url, $vendorId) */
28	const PRODUCT_CREATE = self::OPENAPI_BASE . '/v1/vendors/%d/products';
29
30	/** PATCH update an existing product — sprintf($url, $basalamProductId) */
31	const PRODUCT_UPDATE = self::OPENAPI_BASE . '/v1/products/%d';
32
33	/** POST batch-update products for a vendor */
34	const PRODUCT_BATCH_UPDATE = self::OPENAPI_BASE . '/v1/vendors/%d/products/batch-updates?continue_on_error=true';
35
36	/** GET vendor information — sprintf($url, $vendorId) */
37	const VENDOR_INFO = self::OPENAPI_BASE . '/v1/vendors/%d';
38
39	/** GET category-detection prediction — append encoded title as query param */
40	const CATEGORY_DETECT = self::CATEGORY_BASE . '/category_detection/api_v1.0/predict/';
41
42	/** POST initialize a product media upload */
43	const MEDIA_UPLOAD_REQUEST = self::UPLOAD_BASE . '/v3/media/upload-request';
44
45	/** POST complete a product media upload */
46	const MEDIA_UPLOAD_COMPLETE = self::UPLOAD_BASE . '/v3/media/complete';
47
48	/** GET product media upload status — sprintf($url, $fileId) */
49	const MEDIA_UPLOAD_STATUS = self::UPLOAD_BASE . '/v3/media/status/%s';
50
51	/** GET product data list */
52	const PRODUCTS_DATA = self::CORE_BASE . '/v4/products';
53
54	/** GET commission percentage */
55	const COMMISSION = self::CORE_BASE . '/api_v2/commission/get_percent';
56
57	/** GET full category tree with max preparation days (core v3) */
58	const CATEGORIES_PREPARATION = self::CORE_BASE . '/v3/categories';
59
60	/** GET/POST/PATCH/DELETE webhooks */
61	const WEBHOOKS = self::OPENAPI_BASE . '/v1/webhooks';
62
63	/** GET vendor parcels (orders) */
64	const VENDOR_PARCELS = self::OPENAPI_BASE . '/v1/vendor-parcels';
65
66	// Orders
67
68	/** POST confirm order (set preparation) */
69	const ORDER_CONFIRM = self::ORDER_BASE . '/v1/vendor/set-preparation-order';
70
71	/** POST cancel order */
72	const ORDER_CANCEL = self::ORDER_BASE . '/v1/vendor/set-cancel';
73
74	/** GET/POST cancel request for a specific order — sprintf($url, $orderId) */
75	const ORDER_CANCEL_REQUEST = self::ORDER_BASE . '/v1/vendor/order/%d/cancel-request';
76
77	/** POST delay / overdue agreement request */
78	const ORDER_DELAY = self::ORDER_BASE . '/v1/vendor/orders/%d/new-agreement';
79
80	/** POST set order as shipped (with tracking code) */
81	const ORDER_TRACKING = self::ORDER_BASE . '/v2/vendor/set-posted-order';
82
83	/** GET/POST auto-confirm automation config */
84	const ORDER_AUTO_CONFIRM_CONFIG = self::ORDER_BASE . '/v1/vendor/automation-config';
85
86	/** GET/PATCH specific order — sprintf($url, $vendorId, $invoiceId) */
87	const ORDER_DETAIL = self::ORDER_BASE . '/v2/vendors/%d/orders/%d';
88
89	// Discounts
90
91	/** GET/POST vendor discounts — sprintf($url, $vendorId) */
92	const VENDOR_DISCOUNTS = self::OPENAPI_BASE . '/v1/vendors/%d/discounts';
93
94	// Hamsalam
95
96	/** GET OAuth proxy data */
97	const HAMSALAM_OAUTH_DATA = self::HAMSALAM_BASE . '/basalam-proxy/wp-oauth-data';
98
99	/** POST OAuth get-token proxy */
100	const HAMSALAM_OAUTH_TOKEN = self::HAMSALAM_BASE . '/basalam-proxy/wp-get-token';
101
102	/** GET plugin version detail */
103	const HAMSALAM_VERSION_DETAIL = self::HAMSALAM_BASE . '/wp-sites/version-detail';
104
105	/** GET announcements */
106	const HAMSALAM_ANNOUNCEMENTS = self::HAMSALAM_BASE . '/announcements';
107
108	/** GET/POST all-businesses */
109	const HAMSALAM_BUSINESSES = self::HAMSALAM_BASE . '/all-businesses';
110
111	/** GET Hamsalam auth token */
112	const HAMSALAM_AUTH_TOKEN = self::HAMSALAM_BASE . '/auth/basalam/get-token';
113
114	// Tickets (Hamsalam)
115
116	/** GET/POST ticket list */
117	const TICKET_LIST = self::HAMSALAM_BASE . '/tickets';
118
119	/** GET ticket subjects */
120	const TICKET_SUBJECTS = self::HAMSALAM_BASE . '/tickets/subjects';
121
122	/** GET single ticket — sprintf($url, $ticketId) */
123	const TICKET_DETAIL = self::HAMSALAM_BASE . '/tickets/%d';
124
125	/** POST ticket reply items — sprintf($url, $ticketId) */
126	const TICKET_ITEMS = self::HAMSALAM_BASE . '/tickets/%d/ticket-items';
127
128	/** POST upload ticket media */
129	const TICKET_MEDIA_UPLOAD = self::HAMSALAM_BASE . '/media?type=ticket_item&collection=IMAGE';
130
131	// App Store
132
133	/** POST app review */
134	const APP_REVIEW = self::APPS_BASE . '/v1/apps/13/reviews';
135
136	// Helpers
137
138	/** Build the SSO login URL */
139	public static function oauthLoginUrl(string $clientId, string $scopes, string $redirectUri, string $siteUrl): string
140	{
141	return self::BASALAM_ACCOUNTS
142	. '?client_id=' . $clientId
143	. '&scope=' . $scopes
144	. '&redirect_uri=' . $redirectUri
145	. '&state=' . $siteUrl;
146	}
147	}
148