@anyproto/anytype-mcp 1.0.5 → 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (15) hide show
  1. package/.github/workflows/ci.yml +20 -2
  2. package/.github/workflows/release.yml +7 -1
  3. package/CLAUDE.md +78 -0
  4. package/{LICENSE → LICENSE.md} +8 -8
  5. package/README.md +12 -2
  6. package/bin/cli.mjs +76 -55
  7. package/package.json +27 -21
  8. package/scripts/__tests__/parse-openapi.test.ts +6 -0
  9. package/scripts/__tests__/start-server.test.ts +42 -0
  10. package/server.json +31 -0
  11. package/src/client/__tests__/http-client-upload.test.ts +5 -0
  12. package/src/init-server.ts +6 -1
  13. package/src/openapi/__tests__/parser.test.ts +30 -23
  14. package/test_cases/ebay-api.json +0 -2555
  15. package/test_cases/ebay-api.json.tools +0 -3710
package/test_cases/ebay-api.json.tools DELETED
@@ -1,3710 +0,0 @@
1
- {
2
- "tools": {
3
- "API": {
4
- "methods": [
5
- {
6
- "name": "get_api_ebay_categories_top_level_833ef4a3",
7
- "description": "Get top-level eBay categories\nError Responses:\n400: Invalid request parameters\n401: Unauthorized - Invalid or missing eBay token\n403: Forbidden\n500: Internal server error",
8
- "inputSchema": {
9
- "type": "object",
10
- "properties": {
11
- "userId": {
12
- "type": "string",
13
- "description": "eBay user ID"
14
- },
15
- "siteId": {
16
- "type": "string",
17
- "description": "eBay site ID (e.g., 'EBAY_US')"
18
- }
19
- },
20
- "required": [
21
- "userId",
22
- "siteId"
23
- ]
24
- },
25
- "returnSchema": {
26
- "type": "object",
27
- "properties": {
28
- "status": {
29
- "type": "string",
30
- "enum": [
31
- "success"
32
- ]
33
- },
34
- "data": {
35
- "type": "array",
36
- "items": {
37
- "type": "object",
38
- "properties": {
39
- "id": {
40
- "description": "Category ID",
41
- "oneOf": [
42
- {
43
- "type": "string"
44
- },
45
- {
46
- "type": "number"
47
- }
48
- ]
49
- },
50
- "name": {
51
- "type": "string",
52
- "description": "Category name"
53
- },
54
- "level": {
55
- "type": "number",
56
- "description": "Category level in hierarchy"
57
- },
58
- "parentId": {
59
- "description": "Parent category ID",
60
- "oneOf": [
61
- {
62
- "type": "string"
63
- },
64
- {
65
- "type": "number"
66
- }
67
- ]
68
- },
69
- "isLeaf": {
70
- "type": "boolean",
71
- "description": "Whether this is a leaf category"
72
- },
73
- "fullPath": {
74
- "type": "string",
75
- "description": "Full category path"
76
- },
77
- "parentIds": {
78
- "type": "array",
79
- "description": "Array of parent category IDs",
80
- "items": {
81
- "oneOf": [
82
- {
83
- "type": "string"
84
- },
85
- {
86
- "type": "number"
87
- }
88
- ]
89
- }
90
- }
91
- },
92
- "required": [
93
- "id",
94
- "name",
95
- "level",
96
- "parentId",
97
- "isLeaf"
98
- ],
99
- "additionalProperties": true
100
- }
101
- }
102
- },
103
- "required": [
104
- "status",
105
- "data"
106
- ],
107
- "additionalProperties": true,
108
- "description": "Successful response"
109
- }
110
- },
111
- {
112
- "name": "get_api_ebay_categories_leaves_3ea8b601",
113
- "description": "Get leaf categories\nError Responses:\n400: Invalid request parameters\n401: Unauthorized - Invalid or missing eBay token\n403: Forbidden\n500: Internal server error",
114
- "inputSchema": {
115
- "type": "object",
116
- "properties": {
117
- "categoryId": {
118
- "type": "string",
119
- "description": "Parent category ID"
120
- },
121
- "userId": {
122
- "type": "string",
123
- "description": "eBay user ID"
124
- },
125
- "siteId": {
126
- "type": "string",
127
- "description": "eBay site ID (e.g., 'EBAY_US')"
128
- }
129
- },
130
- "required": [
131
- "categoryId",
132
- "userId",
133
- "siteId"
134
- ]
135
- },
136
- "returnSchema": {
137
- "type": "object",
138
- "properties": {
139
- "status": {
140
- "type": "string",
141
- "enum": [
142
- "success"
143
- ]
144
- },
145
- "data": {
146
- "type": "array",
147
- "items": {
148
- "type": "object",
149
- "properties": {
150
- "id": {
151
- "description": "Category ID",
152
- "oneOf": [
153
- {
154
- "type": "string"
155
- },
156
- {
157
- "type": "number"
158
- }
159
- ]
160
- },
161
- "name": {
162
- "type": "string",
163
- "description": "Category name"
164
- },
165
- "level": {
166
- "type": "number",
167
- "description": "Category level in hierarchy"
168
- },
169
- "parentId": {
170
- "description": "Parent category ID",
171
- "oneOf": [
172
- {
173
- "type": "string"
174
- },
175
- {
176
- "type": "number"
177
- }
178
- ]
179
- },
180
- "isLeaf": {
181
- "type": "boolean",
182
- "description": "Whether this is a leaf category"
183
- },
184
- "fullPath": {
185
- "type": "string",
186
- "description": "Full category path"
187
- },
188
- "parentIds": {
189
- "type": "array",
190
- "description": "Array of parent category IDs",
191
- "items": {
192
- "oneOf": [
193
- {
194
- "type": "string"
195
- },
196
- {
197
- "type": "number"
198
- }
199
- ]
200
- }
201
- }
202
- },
203
- "required": [
204
- "id",
205
- "name",
206
- "level",
207
- "parentId",
208
- "isLeaf"
209
- ],
210
- "additionalProperties": true
211
- }
212
- }
213
- },
214
- "required": [
215
- "status",
216
- "data"
217
- ],
218
- "additionalProperties": true,
219
- "description": "Successful response"
220
- }
221
- },
222
- {
223
- "name": "get_api_ebay_categories_conditions_0196f1da",
224
- "description": "Get category condition policies\nError Responses:\n400: Invalid request parameters\n401: Unauthorized - Invalid or missing eBay token\n403: Forbidden\n404: No condition policies found for the category\n500: Internal server error",
225
- "inputSchema": {
226
- "type": "object",
227
- "properties": {
228
- "categoryId": {
229
- "type": "string",
230
- "description": "Category ID"
231
- },
232
- "userId": {
233
- "type": "string",
234
- "description": "eBay user ID"
235
- },
236
- "marketplaceId": {
237
- "type": "string",
238
- "description": "eBay marketplace ID (e.g., 'EBAY_US')"
239
- }
240
- },
241
- "required": [
242
- "categoryId",
243
- "userId",
244
- "marketplaceId"
245
- ]
246
- },
247
- "returnSchema": {
248
- "type": "object",
249
- "properties": {
250
- "status": {
251
- "type": "string",
252
- "enum": [
253
- "success"
254
- ]
255
- },
256
- "data": {
257
- "type": "object",
258
- "properties": {
259
- "categoryId": {
260
- "description": "The category ID",
261
- "oneOf": [
262
- {
263
- "type": "string"
264
- },
265
- {
266
- "type": "number"
267
- }
268
- ]
269
- },
270
- "conditionDescriptors": {
271
- "type": "array",
272
- "items": {
273
- "type": "object",
274
- "properties": {
275
- "id": {
276
- "type": "string",
277
- "description": "The condition ID"
278
- },
279
- "description": {
280
- "type": "string",
281
- "description": "Description of the condition"
282
- }
283
- },
284
- "required": [
285
- "id"
286
- ],
287
- "additionalProperties": true
288
- }
289
- }
290
- },
291
- "required": [
292
- "categoryId",
293
- "conditionDescriptors"
294
- ],
295
- "additionalProperties": true
296
- }
297
- },
298
- "required": [
299
- "status",
300
- "data"
301
- ],
302
- "additionalProperties": true,
303
- "description": "Successful response"
304
- }
305
- },
306
- {
307
- "name": "get_api_ebay_categories_aspects_59d62e7d",
308
- "description": "Get category aspects\nError Responses:\n400: Invalid request parameters\n401: Unauthorized - Invalid or missing eBay token\n403: Forbidden\n404: No aspects found for the category\n500: Internal server error",
309
- "inputSchema": {
310
- "type": "object",
311
- "properties": {
312
- "categoryId": {
313
- "type": "string",
314
- "description": "Category ID"
315
- },
316
- "userId": {
317
- "type": "string",
318
- "description": "eBay user ID"
319
- },
320
- "marketplaceId": {
321
- "type": "string",
322
- "description": "eBay marketplace ID (e.g., 'EBAY_US')"
323
- }
324
- },
325
- "required": [
326
- "categoryId",
327
- "userId",
328
- "marketplaceId"
329
- ]
330
- },
331
- "returnSchema": {
332
- "type": "object",
333
- "properties": {
334
- "status": {
335
- "type": "string",
336
- "enum": [
337
- "success"
338
- ]
339
- },
340
- "data": {
341
- "type": "object",
342
- "properties": {
343
- "aspects": {
344
- "type": "array",
345
- "items": {
346
- "type": "object",
347
- "properties": {
348
- "localizedAspectName": {
349
- "type": "string"
350
- },
351
- "aspectConstraint": {
352
- "type": "object",
353
- "properties": {
354
- "aspectDataType": {
355
- "type": "string",
356
- "enum": [
357
- "DATE",
358
- "NUMBER",
359
- "STRING",
360
- "TEXT"
361
- ]
362
- },
363
- "aspectEnabledForVariations": {
364
- "type": "boolean"
365
- },
366
- "aspectFormat": {
367
- "type": "string"
368
- },
369
- "aspectMaxLength": {
370
- "type": "number"
371
- },
372
- "aspectMode": {
373
- "type": "string",
374
- "enum": [
375
- "FREE_TEXT",
376
- "SELECTION_ONLY"
377
- ]
378
- },
379
- "aspectRequired": {
380
- "type": "boolean"
381
- },
382
- "aspectUsage": {
383
- "type": "string",
384
- "enum": [
385
- "RECOMMENDED",
386
- "OPTIONAL"
387
- ]
388
- },
389
- "expectedRequiredByDate": {
390
- "type": "string"
391
- },
392
- "itemToAspectCardinality": {
393
- "type": "string",
394
- "enum": [
395
- "MULTI",
396
- "SINGLE"
397
- ]
398
- }
399
- },
400
- "required": [
401
- "aspectDataType",
402
- "aspectEnabledForVariations",
403
- "aspectMode",
404
- "aspectRequired",
405
- "aspectUsage",
406
- "itemToAspectCardinality"
407
- ],
408
- "additionalProperties": true
409
- },
410
- "aspectValues": {
411
- "type": "array",
412
- "items": {
413
- "type": "string"
414
- }
415
- },
416
- "relevanceIndicator": {
417
- "type": "object",
418
- "properties": {
419
- "searchCount": {
420
- "type": "number"
421
- }
422
- },
423
- "required": [
424
- "searchCount"
425
- ],
426
- "additionalProperties": true
427
- }
428
- },
429
- "required": [
430
- "localizedAspectName",
431
- "aspectConstraint"
432
- ],
433
- "additionalProperties": true
434
- }
435
- }
436
- },
437
- "required": [
438
- "aspects"
439
- ],
440
- "additionalProperties": true
441
- }
442
- },
443
- "required": [
444
- "status",
445
- "data"
446
- ],
447
- "additionalProperties": true,
448
- "description": "Successful response"
449
- }
450
- },
451
- {
452
- "name": "get_api_ebay_categories_listing_requirements_700b6d7f",
453
- "description": "Get category listing requirements\nError Responses:\n400: Invalid request parameters\n401: Unauthorized - Invalid or missing eBay token\n403: Forbidden\n404: No aspects or conditions found for the category\n500: Internal server error",
454
- "inputSchema": {
455
- "type": "object",
456
- "properties": {
457
- "categoryId": {
458
- "type": "string",
459
- "description": "Category ID"
460
- },
461
- "userId": {
462
- "type": "string",
463
- "description": "eBay user ID"
464
- },
465
- "marketplaceId": {
466
- "type": "string",
467
- "description": "eBay marketplace ID (e.g., 'EBAY_US')"
468
- }
469
- },
470
- "required": [
471
- "categoryId",
472
- "userId",
473
- "marketplaceId"
474
- ]
475
- },
476
- "returnSchema": {
477
- "type": "object",
478
- "properties": {
479
- "status": {
480
- "type": "string",
481
- "enum": [
482
- "success"
483
- ]
484
- },
485
- "data": {
486
- "type": "object",
487
- "properties": {
488
- "categoryId": {
489
- "oneOf": [
490
- {
491
- "type": "string"
492
- },
493
- {
494
- "type": "number"
495
- }
496
- ]
497
- },
498
- "aspects": {
499
- "type": "array",
500
- "items": {
501
- "type": "object",
502
- "properties": {
503
- "localizedAspectName": {
504
- "type": "string"
505
- },
506
- "aspectConstraint": {
507
- "type": "object",
508
- "properties": {
509
- "aspectDataType": {
510
- "type": "string",
511
- "enum": [
512
- "DATE",
513
- "NUMBER",
514
- "STRING",
515
- "TEXT"
516
- ]
517
- },
518
- "aspectEnabledForVariations": {
519
- "type": "boolean"
520
- },
521
- "aspectFormat": {
522
- "type": "string"
523
- },
524
- "aspectMaxLength": {
525
- "type": "number"
526
- },
527
- "aspectMode": {
528
- "type": "string",
529
- "enum": [
530
- "FREE_TEXT",
531
- "SELECTION_ONLY"
532
- ]
533
- },
534
- "aspectRequired": {
535
- "type": "boolean"
536
- },
537
- "aspectUsage": {
538
- "type": "string",
539
- "enum": [
540
- "RECOMMENDED",
541
- "OPTIONAL"
542
- ]
543
- },
544
- "expectedRequiredByDate": {
545
- "type": "string"
546
- },
547
- "itemToAspectCardinality": {
548
- "type": "string",
549
- "enum": [
550
- "MULTI",
551
- "SINGLE"
552
- ]
553
- }
554
- },
555
- "required": [
556
- "aspectDataType",
557
- "aspectEnabledForVariations",
558
- "aspectMode",
559
- "aspectRequired",
560
- "aspectUsage",
561
- "itemToAspectCardinality"
562
- ],
563
- "additionalProperties": true
564
- },
565
- "aspectValues": {
566
- "type": "array",
567
- "items": {
568
- "type": "string"
569
- }
570
- },
571
- "relevanceIndicator": {
572
- "type": "object",
573
- "properties": {
574
- "searchCount": {
575
- "type": "number"
576
- }
577
- },
578
- "required": [
579
- "searchCount"
580
- ],
581
- "additionalProperties": true
582
- }
583
- },
584
- "required": [
585
- "localizedAspectName",
586
- "aspectConstraint"
587
- ],
588
- "additionalProperties": true
589
- }
590
- },
591
- "conditions": {
592
- "type": "array",
593
- "items": {
594
- "type": "object",
595
- "properties": {
596
- "id": {
597
- "type": "string"
598
- },
599
- "description": {
600
- "type": "string"
601
- }
602
- },
603
- "required": [
604
- "id"
605
- ],
606
- "additionalProperties": true
607
- }
608
- }
609
- },
610
- "required": [
611
- "categoryId",
612
- "aspects",
613
- "conditions"
614
- ],
615
- "additionalProperties": true
616
- }
617
- },
618
- "required": [
619
- "status",
620
- "data"
621
- ],
622
- "additionalProperties": true,
623
- "description": "Successful response"
624
- }
625
- },
626
- {
627
- "name": "post_api_ebay_listings_auction_fe15420c",
628
- "description": "Create a new auction listing\nError Responses:\n400: Invalid request parameters or eBay API validation error\n401: Unauthorized - Invalid or missing eBay token\n403: Forbidden - Insufficient permissions or business policy error\n500: Internal server error",
629
- "inputSchema": {
630
- "type": "object",
631
- "properties": {
632
- "userId": {
633
- "type": "string",
634
- "description": "eBay user ID"
635
- },
636
- "title": {
637
- "type": "string",
638
- "description": "Listing title"
639
- },
640
- "description": {
641
- "type": "string",
642
- "description": "Listing description"
643
- },
644
- "categoryId": {
645
- "type": "string",
646
- "description": "eBay category ID"
647
- },
648
- "conditionId": {
649
- "type": "number",
650
- "description": "Item condition ID"
651
- },
652
- "startPrice": {
653
- "type": "number",
654
- "description": "Starting price"
655
- },
656
- "buyItNowPrice": {
657
- "type": "number",
658
- "description": "Buy it now price"
659
- },
660
- "listingDuration": {
661
- "type": "string",
662
- "description": "Duration of the listing",
663
- "default": "Days_7"
664
- },
665
- "shippingCost": {
666
- "type": "number",
667
- "description": "Shipping cost"
668
- },
669
- "postalCode": {
670
- "type": "string",
671
- "description": "Postal code for shipping"
672
- },
673
- "dispatchTimeMax": {
674
- "type": "integer",
675
- "description": "Maximum dispatch time in days"
676
- },
677
- "images": {
678
- "type": "object",
679
- "description": "Images for the listing",
680
- "properties": {
681
- "base64": {
682
- "type": "array",
683
- "description": "Array of base64 encoded images",
684
- "items": {
685
- "type": "string"
686
- }
687
- },
688
- "urls": {
689
- "type": "array",
690
- "description": "Array of image URLs",
691
- "items": {
692
- "type": "string",
693
- "format": "uri"
694
- }
695
- }
696
- },
697
- "additionalProperties": true
698
- }
699
- },
700
- "required": [
701
- "userId",
702
- "title",
703
- "description",
704
- "categoryId",
705
- "startPrice",
706
- "shippingCost",
707
- "postalCode",
708
- "dispatchTimeMax",
709
- "images"
710
- ]
711
- },
712
- "returnSchema": {
713
- "oneOf": [
714
- {
715
- "type": "object",
716
- "properties": {
717
- "status": {
718
- "type": "string",
719
- "enum": [
720
- "success"
721
- ]
722
- },
723
- "data": {
724
- "type": "object",
725
- "properties": {
726
- "itemId": {
727
- "type": "string",
728
- "description": "eBay item ID"
729
- },
730
- "title": {
731
- "type": "string",
732
- "description": "Listing title"
733
- },
734
- "startTime": {
735
- "type": "string",
736
- "description": "Listing start time"
737
- },
738
- "endTime": {
739
- "type": "string",
740
- "description": "Listing end time"
741
- }
742
- },
743
- "required": [
744
- "itemId",
745
- "title",
746
- "startTime",
747
- "endTime"
748
- ],
749
- "additionalProperties": true
750
- }
751
- },
752
- "required": [
753
- "status",
754
- "data"
755
- ],
756
- "additionalProperties": true
757
- },
758
- {
759
- "type": "object",
760
- "properties": {
761
- "status": {
762
- "type": "string",
763
- "enum": [
764
- "error"
765
- ]
766
- },
767
- "message": {
768
- "type": "string"
769
- },
770
- "errorType": {
771
- "type": "string",
772
- "enum": [
773
- "VALIDATION_ERROR",
774
- "BUSINESS_POLICIES_ERROR",
775
- "EBAY_API_ERROR",
776
- "AUTH_ERROR",
777
- "INTERNAL_ERROR"
778
- ]
779
- },
780
- "errors": {
781
- "type": "array",
782
- "items": {}
783
- }
784
- },
785
- "required": [
786
- "status",
787
- "message",
788
- "errorType"
789
- ],
790
- "additionalProperties": true
791
- }
792
- ],
793
- "description": "Successful response"
794
- }
795
- },
796
- {
797
- "name": "post_api_listings_advanced_1cdf2764",
798
- "description": "Create an advanced listing with full eBay Trading API support\nError Responses:\n400: Invalid request parameters or eBay API validation error\n401: Unauthorized - Invalid or missing eBay token\n403: Forbidden - Insufficient permissions or business policy error\n500: Internal server error",
799
- "inputSchema": {
800
- "type": "object",
801
- "properties": {
802
- "site": {
803
- "type": "string",
804
- "description": "The eBay site ID to list on"
805
- },
806
- "userId": {
807
- "type": "string",
808
- "description": "The eBay user ID to authenticate as"
809
- },
810
- "item": {
811
- "type": "object",
812
- "properties": {
813
- "title": {
814
- "type": "string"
815
- },
816
- "primaryCategory": {
817
- "type": "object",
818
- "properties": {
819
- "categoryId": {
820
- "type": "string"
821
- },
822
- "categoryName": {
823
- "type": "string"
824
- }
825
- },
826
- "required": [
827
- "categoryId"
828
- ],
829
- "additionalProperties": true
830
- },
831
- "quantity": {
832
- "type": "integer"
833
- },
834
- "itemSpecifics": {
835
- "type": "object",
836
- "additionalProperties": {
837
- "oneOf": [
838
- {
839
- "type": "string"
840
- },
841
- {
842
- "type": "array",
843
- "items": {
844
- "type": "string"
845
- }
846
- }
847
- ]
848
- }
849
- },
850
- "startPrice": {
851
- "type": "object",
852
- "properties": {
853
- "value": {
854
- "type": "number"
855
- },
856
- "currencyId": {
857
- "type": "string"
858
- }
859
- },
860
- "required": [
861
- "value",
862
- "currencyId"
863
- ],
864
- "additionalProperties": true
865
- },
866
- "description": {
867
- "type": "string"
868
- },
869
- "listingDuration": {
870
- "type": "string"
871
- },
872
- "listingType": {
873
- "type": "string"
874
- },
875
- "location": {
876
- "type": "string"
877
- },
878
- "country": {
879
- "type": "string"
880
- },
881
- "currency": {
882
- "type": "string"
883
- },
884
- "paymentMethods": {
885
- "type": "array",
886
- "items": {
887
- "type": "string"
888
- }
889
- },
890
- "dispatchTimeMax": {
891
- "type": "integer",
892
- "default": 3
893
- },
894
- "pictureDetails": {
895
- "type": "object",
896
- "properties": {
897
- "galleryType": {
898
- "type": "string"
899
- },
900
- "pictureUrl": {
901
- "type": "array",
902
- "items": {
903
- "type": "string",
904
- "format": "uri"
905
- }
906
- }
907
- },
908
- "required": [
909
- "galleryType"
910
- ],
911
- "additionalProperties": true
912
- },
913
- "returnPolicy": {
914
- "type": "object",
915
- "properties": {
916
- "returnsAcceptedOption": {
917
- "type": "string",
918
- "enum": [
919
- "ReturnsAccepted",
920
- "ReturnsNotAccepted"
921
- ]
922
- },
923
- "returnsWithinOption": {
924
- "type": "string"
925
- },
926
- "description": {
927
- "type": "string"
928
- }
929
- },
930
- "required": [
931
- "returnsAcceptedOption",
932
- "description"
933
- ],
934
- "additionalProperties": true
935
- },
936
- "shippingDetails": {
937
- "type": "object",
938
- "properties": {
939
- "shippingType": {
940
- "type": "string"
941
- },
942
- "shippingServiceOptions": {
943
- "type": "array",
944
- "items": {
945
- "type": "object",
946
- "properties": {
947
- "shippingService": {
948
- "type": "string"
949
- },
950
- "shippingServiceCost": {
951
- "type": "object",
952
- "properties": {
953
- "value": {
954
- "type": "number"
955
- },
956
- "currencyId": {
957
- "type": "string"
958
- }
959
- },
960
- "required": [
961
- "value",
962
- "currencyId"
963
- ],
964
- "additionalProperties": true
965
- },
966
- "freeShipping": {
967
- "type": "boolean"
968
- }
969
- },
970
- "required": [
971
- "shippingService"
972
- ],
973
- "additionalProperties": true
974
- }
975
- }
976
- },
977
- "required": [
978
- "shippingType",
979
- "shippingServiceOptions"
980
- ],
981
- "additionalProperties": true
982
- },
983
- "conditionId": {
984
- "type": "integer"
985
- },
986
- "conditionDescription": {
987
- "type": "string"
988
- }
989
- },
990
- "required": [
991
- "title",
992
- "primaryCategory",
993
- "quantity",
994
- "startPrice",
995
- "location"
996
- ],
997
- "additionalProperties": true
998
- },
999
- "errorLanguage": {
1000
- "type": "string"
1001
- },
1002
- "warningLevel": {
1003
- "type": "string"
1004
- }
1005
- },
1006
- "required": [
1007
- "site",
1008
- "userId",
1009
- "item"
1010
- ]
1011
- },
1012
- "returnSchema": {
1013
- "type": "object",
1014
- "properties": {
1015
- "itemId": {
1016
- "type": "string"
1017
- },
1018
- "startTime": {
1019
- "type": "string"
1020
- },
1021
- "endTime": {
1022
- "type": "string"
1023
- },
1024
- "fees": {
1025
- "type": "array",
1026
- "items": {
1027
- "type": "object",
1028
- "properties": {
1029
- "name": {
1030
- "type": "string"
1031
- },
1032
- "fee": {
1033
- "type": "object",
1034
- "properties": {
1035
- "value": {
1036
- "type": "number"
1037
- },
1038
- "currencyId": {
1039
- "type": "string"
1040
- }
1041
- },
1042
- "required": [
1043
- "value",
1044
- "currencyId"
1045
- ],
1046
- "additionalProperties": true
1047
- }
1048
- },
1049
- "required": [
1050
- "name",
1051
- "fee"
1052
- ],
1053
- "additionalProperties": true
1054
- }
1055
- },
1056
- "category": {
1057
- "type": "object",
1058
- "properties": {
1059
- "categoryId": {
1060
- "type": "string"
1061
- },
1062
- "categoryName": {
1063
- "type": "string"
1064
- }
1065
- },
1066
- "required": [
1067
- "categoryId"
1068
- ],
1069
- "additionalProperties": true
1070
- },
1071
- "message": {
1072
- "type": "string"
1073
- }
1074
- },
1075
- "required": [
1076
- "itemId",
1077
- "startTime",
1078
- "endTime",
1079
- "fees",
1080
- "category",
1081
- "message"
1082
- ],
1083
- "additionalProperties": true,
1084
- "description": "Successful response"
1085
- }
1086
- },
1087
- {
1088
- "name": "post_api_images_upload_830cd0c4",
1089
- "description": "Upload multiple images\nError Responses:\n400: Invalid request parameters or file validation error\n401: Unauthorized\n403: Forbidden\n500: Internal server error",
1090
- "inputSchema": {
1091
- "type": "object",
1092
- "properties": {
1093
- "images": {
1094
- "type": "array",
1095
- "description": "Image files to upload. Supports JPEG, PNG, GIF, and WebP formats. Maximum 12 files, each up to 5MB.",
1096
- "items": {
1097
- "type": "string",
1098
- "format": "uri-reference",
1099
- "description": "absolute paths to local files"
1100
- }
1101
- }
1102
- },
1103
- "required": [
1104
- "images"
1105
- ]
1106
- },
1107
- "returnSchema": {
1108
- "oneOf": [
1109
- {
1110
- "type": "object",
1111
- "properties": {
1112
- "status": {
1113
- "type": "string",
1114
- "enum": [
1115
- "success"
1116
- ]
1117
- },
1118
- "data": {
1119
- "type": "object",
1120
- "properties": {
1121
- "urls": {
1122
- "type": "array",
1123
- "description": "URLs of the uploaded images",
1124
- "items": {
1125
- "type": "string",
1126
- "format": "uri"
1127
- }
1128
- }
1129
- },
1130
- "required": [
1131
- "urls"
1132
- ],
1133
- "additionalProperties": true
1134
- }
1135
- },
1136
- "required": [
1137
- "status",
1138
- "data"
1139
- ],
1140
- "additionalProperties": true
1141
- },
1142
- {
1143
- "type": "object",
1144
- "properties": {
1145
- "status": {
1146
- "type": "string",
1147
- "enum": [
1148
- "error"
1149
- ]
1150
- },
1151
- "message": {
1152
- "type": "string"
1153
- },
1154
- "errorType": {
1155
- "type": "string",
1156
- "enum": [
1157
- "VALIDATION_ERROR",
1158
- "UPLOAD_ERROR",
1159
- "INTERNAL_ERROR"
1160
- ]
1161
- }
1162
- },
1163
- "required": [
1164
- "status",
1165
- "message",
1166
- "errorType"
1167
- ],
1168
- "additionalProperties": true
1169
- }
1170
- ],
1171
- "description": "Successful response"
1172
- }
1173
- }
1174
- ]
1175
- }
1176
- },
1177
- "openApiLookup": {
1178
- "API-get_api_ebay_categories_top_level_833ef4a3": {
1179
- "tags": [
1180
- "Categories"
1181
- ],
1182
- "summary": "Get top-level eBay categories",
1183
- "description": "Returns a list of all top-level categories for the specified eBay site",
1184
- "security": [
1185
- {
1186
- "bearer": [
1187
- "https://api.ebay.com/oauth/api_scope"
1188
- ]
1189
- }
1190
- ],
1191
- "parameters": [
1192
- {
1193
- "name": "userId",
1194
- "in": "query",
1195
- "required": true,
1196
- "schema": {
1197
- "type": "string",
1198
- "description": "eBay user ID"
1199
- },
1200
- "description": "eBay user ID"
1201
- },
1202
- {
1203
- "name": "siteId",
1204
- "in": "query",
1205
- "required": true,
1206
- "schema": {
1207
- "type": "string",
1208
- "description": "eBay site ID (e.g., 'EBAY_US')"
1209
- },
1210
- "description": "eBay site ID (e.g., 'EBAY_US')"
1211
- }
1212
- ],
1213
- "responses": {
1214
- "200": {
1215
- "description": "Successful response",
1216
- "content": {
1217
- "application/json": {
1218
- "schema": {
1219
- "type": "object",
1220
- "properties": {
1221
- "status": {
1222
- "type": "string",
1223
- "enum": [
1224
- "success"
1225
- ]
1226
- },
1227
- "data": {
1228
- "type": "array",
1229
- "items": {
1230
- "type": "object",
1231
- "properties": {
1232
- "id": {
1233
- "oneOf": [
1234
- {
1235
- "type": "string"
1236
- },
1237
- {
1238
- "type": "number"
1239
- }
1240
- ],
1241
- "description": "Category ID"
1242
- },
1243
- "name": {
1244
- "type": "string",
1245
- "description": "Category name"
1246
- },
1247
- "level": {
1248
- "type": "number",
1249
- "description": "Category level in hierarchy"
1250
- },
1251
- "parentId": {
1252
- "oneOf": [
1253
- {
1254
- "type": "string"
1255
- },
1256
- {
1257
- "type": "number"
1258
- }
1259
- ],
1260
- "description": "Parent category ID"
1261
- },
1262
- "isLeaf": {
1263
- "type": "boolean",
1264
- "description": "Whether this is a leaf category"
1265
- },
1266
- "fullPath": {
1267
- "type": "string",
1268
- "description": "Full category path"
1269
- },
1270
- "parentIds": {
1271
- "type": "array",
1272
- "items": {
1273
- "oneOf": [
1274
- {
1275
- "type": "string"
1276
- },
1277
- {
1278
- "type": "number"
1279
- }
1280
- ]
1281
- },
1282
- "description": "Array of parent category IDs"
1283
- }
1284
- },
1285
- "required": [
1286
- "id",
1287
- "name",
1288
- "level",
1289
- "parentId",
1290
- "isLeaf"
1291
- ]
1292
- }
1293
- }
1294
- },
1295
- "required": [
1296
- "status",
1297
- "data"
1298
- ]
1299
- }
1300
- }
1301
- }
1302
- },
1303
- "400": {
1304
- "description": "Invalid request parameters",
1305
- "content": {
1306
- "application/json": {
1307
- "schema": {
1308
- "type": "object",
1309
- "properties": {
1310
- "error": {
1311
- "type": "string"
1312
- },
1313
- "code": {
1314
- "type": "string"
1315
- },
1316
- "details": {
1317
- "type": "array",
1318
- "items": {}
1319
- }
1320
- },
1321
- "required": [
1322
- "error",
1323
- "code"
1324
- ]
1325
- }
1326
- }
1327
- }
1328
- },
1329
- "401": {
1330
- "description": "Unauthorized - Invalid or missing eBay token",
1331
- "content": {
1332
- "application/json": {
1333
- "schema": {
1334
- "type": "object",
1335
- "properties": {
1336
- "error": {
1337
- "type": "string"
1338
- },
1339
- "code": {
1340
- "type": "string"
1341
- },
1342
- "details": {
1343
- "type": "array",
1344
- "items": {}
1345
- }
1346
- },
1347
- "required": [
1348
- "error",
1349
- "code"
1350
- ]
1351
- }
1352
- }
1353
- }
1354
- },
1355
- "403": {
1356
- "description": "Forbidden",
1357
- "content": {
1358
- "application/json": {
1359
- "schema": {
1360
- "type": "object",
1361
- "properties": {
1362
- "error": {
1363
- "type": "string"
1364
- },
1365
- "code": {
1366
- "type": "string"
1367
- },
1368
- "details": {
1369
- "type": "array",
1370
- "items": {}
1371
- }
1372
- },
1373
- "required": [
1374
- "error",
1375
- "code"
1376
- ]
1377
- }
1378
- }
1379
- }
1380
- },
1381
- "500": {
1382
- "description": "Internal server error",
1383
- "content": {
1384
- "application/json": {
1385
- "schema": {
1386
- "type": "object",
1387
- "properties": {
1388
- "error": {
1389
- "type": "string"
1390
- },
1391
- "code": {
1392
- "type": "string"
1393
- },
1394
- "details": {
1395
- "type": "array",
1396
- "items": {}
1397
- }
1398
- },
1399
- "required": [
1400
- "error",
1401
- "code"
1402
- ]
1403
- }
1404
- }
1405
- }
1406
- }
1407
- },
1408
- "operationId": "get_api_ebay_categories_top_level_833ef4a3",
1409
- "method": "get",
1410
- "path": "/api/ebay/categories/top-level"
1411
- },
1412
- "API-get_api_ebay_categories_leaves_3ea8b601": {
1413
- "tags": [
1414
- "Categories"
1415
- ],
1416
- "summary": "Get leaf categories",
1417
- "description": "Returns all leaf categories under the specified parent category",
1418
- "security": [
1419
- {
1420
- "bearer": [
1421
- "https://api.ebay.com/oauth/api_scope"
1422
- ]
1423
- }
1424
- ],
1425
- "parameters": [
1426
- {
1427
- "name": "categoryId",
1428
- "in": "path",
1429
- "required": true,
1430
- "schema": {
1431
- "type": "string",
1432
- "description": "Parent category ID"
1433
- },
1434
- "description": "Parent category ID"
1435
- },
1436
- {
1437
- "name": "userId",
1438
- "in": "query",
1439
- "required": true,
1440
- "schema": {
1441
- "type": "string",
1442
- "description": "eBay user ID"
1443
- },
1444
- "description": "eBay user ID"
1445
- },
1446
- {
1447
- "name": "siteId",
1448
- "in": "query",
1449
- "required": true,
1450
- "schema": {
1451
- "type": "string",
1452
- "description": "eBay site ID (e.g., 'EBAY_US')"
1453
- },
1454
- "description": "eBay site ID (e.g., 'EBAY_US')"
1455
- }
1456
- ],
1457
- "responses": {
1458
- "200": {
1459
- "description": "Successful response",
1460
- "content": {
1461
- "application/json": {
1462
- "schema": {
1463
- "type": "object",
1464
- "properties": {
1465
- "status": {
1466
- "type": "string",
1467
- "enum": [
1468
- "success"
1469
- ]
1470
- },
1471
- "data": {
1472
- "type": "array",
1473
- "items": {
1474
- "type": "object",
1475
- "properties": {
1476
- "id": {
1477
- "oneOf": [
1478
- {
1479
- "type": "string"
1480
- },
1481
- {
1482
- "type": "number"
1483
- }
1484
- ],
1485
- "description": "Category ID"
1486
- },
1487
- "name": {
1488
- "type": "string",
1489
- "description": "Category name"
1490
- },
1491
- "level": {
1492
- "type": "number",
1493
- "description": "Category level in hierarchy"
1494
- },
1495
- "parentId": {
1496
- "oneOf": [
1497
- {
1498
- "type": "string"
1499
- },
1500
- {
1501
- "type": "number"
1502
- }
1503
- ],
1504
- "description": "Parent category ID"
1505
- },
1506
- "isLeaf": {
1507
- "type": "boolean",
1508
- "description": "Whether this is a leaf category"
1509
- },
1510
- "fullPath": {
1511
- "type": "string",
1512
- "description": "Full category path"
1513
- },
1514
- "parentIds": {
1515
- "type": "array",
1516
- "items": {
1517
- "oneOf": [
1518
- {
1519
- "type": "string"
1520
- },
1521
- {
1522
- "type": "number"
1523
- }
1524
- ]
1525
- },
1526
- "description": "Array of parent category IDs"
1527
- }
1528
- },
1529
- "required": [
1530
- "id",
1531
- "name",
1532
- "level",
1533
- "parentId",
1534
- "isLeaf"
1535
- ]
1536
- }
1537
- }
1538
- },
1539
- "required": [
1540
- "status",
1541
- "data"
1542
- ]
1543
- }
1544
- }
1545
- }
1546
- },
1547
- "400": {
1548
- "description": "Invalid request parameters",
1549
- "content": {
1550
- "application/json": {
1551
- "schema": {
1552
- "type": "object",
1553
- "properties": {
1554
- "error": {
1555
- "type": "string"
1556
- },
1557
- "code": {
1558
- "type": "string"
1559
- },
1560
- "details": {
1561
- "type": "array",
1562
- "items": {}
1563
- }
1564
- },
1565
- "required": [
1566
- "error",
1567
- "code"
1568
- ]
1569
- }
1570
- }
1571
- }
1572
- },
1573
- "401": {
1574
- "description": "Unauthorized - Invalid or missing eBay token",
1575
- "content": {
1576
- "application/json": {
1577
- "schema": {
1578
- "type": "object",
1579
- "properties": {
1580
- "error": {
1581
- "type": "string"
1582
- },
1583
- "code": {
1584
- "type": "string"
1585
- },
1586
- "details": {
1587
- "type": "array",
1588
- "items": {}
1589
- }
1590
- },
1591
- "required": [
1592
- "error",
1593
- "code"
1594
- ]
1595
- }
1596
- }
1597
- }
1598
- },
1599
- "403": {
1600
- "description": "Forbidden",
1601
- "content": {
1602
- "application/json": {
1603
- "schema": {
1604
- "type": "object",
1605
- "properties": {
1606
- "error": {
1607
- "type": "string"
1608
- },
1609
- "code": {
1610
- "type": "string"
1611
- },
1612
- "details": {
1613
- "type": "array",
1614
- "items": {}
1615
- }
1616
- },
1617
- "required": [
1618
- "error",
1619
- "code"
1620
- ]
1621
- }
1622
- }
1623
- }
1624
- },
1625
- "500": {
1626
- "description": "Internal server error",
1627
- "content": {
1628
- "application/json": {
1629
- "schema": {
1630
- "type": "object",
1631
- "properties": {
1632
- "error": {
1633
- "type": "string"
1634
- },
1635
- "code": {
1636
- "type": "string"
1637
- },
1638
- "details": {
1639
- "type": "array",
1640
- "items": {}
1641
- }
1642
- },
1643
- "required": [
1644
- "error",
1645
- "code"
1646
- ]
1647
- }
1648
- }
1649
- }
1650
- }
1651
- },
1652
- "operationId": "get_api_ebay_categories_leaves_3ea8b601",
1653
- "method": "get",
1654
- "path": "/api/ebay/categories/leaves/{categoryId}"
1655
- },
1656
- "API-get_api_ebay_categories_conditions_0196f1da": {
1657
- "tags": [
1658
- "Categories"
1659
- ],
1660
- "summary": "Get category condition policies",
1661
- "description": "Returns the condition policies for a specific category",
1662
- "security": [
1663
- {
1664
- "bearer": [
1665
- "https://api.ebay.com/oauth/api_scope"
1666
- ]
1667
- }
1668
- ],
1669
- "parameters": [
1670
- {
1671
- "name": "categoryId",
1672
- "in": "path",
1673
- "required": true,
1674
- "schema": {
1675
- "type": "string",
1676
- "description": "Category ID"
1677
- },
1678
- "description": "Category ID"
1679
- },
1680
- {
1681
- "name": "userId",
1682
- "in": "query",
1683
- "required": true,
1684
- "schema": {
1685
- "type": "string",
1686
- "description": "eBay user ID"
1687
- },
1688
- "description": "eBay user ID"
1689
- },
1690
- {
1691
- "name": "marketplaceId",
1692
- "in": "query",
1693
- "required": true,
1694
- "schema": {
1695
- "type": "string",
1696
- "description": "eBay marketplace ID (e.g., 'EBAY_US')"
1697
- },
1698
- "description": "eBay marketplace ID (e.g., 'EBAY_US')"
1699
- }
1700
- ],
1701
- "responses": {
1702
- "200": {
1703
- "description": "Successful response",
1704
- "content": {
1705
- "application/json": {
1706
- "schema": {
1707
- "type": "object",
1708
- "properties": {
1709
- "status": {
1710
- "type": "string",
1711
- "enum": [
1712
- "success"
1713
- ]
1714
- },
1715
- "data": {
1716
- "type": "object",
1717
- "properties": {
1718
- "categoryId": {
1719
- "oneOf": [
1720
- {
1721
- "type": "string"
1722
- },
1723
- {
1724
- "type": "number"
1725
- }
1726
- ],
1727
- "description": "The category ID"
1728
- },
1729
- "conditionDescriptors": {
1730
- "type": "array",
1731
- "items": {
1732
- "type": "object",
1733
- "properties": {
1734
- "id": {
1735
- "type": "string",
1736
- "description": "The condition ID"
1737
- },
1738
- "description": {
1739
- "type": "string",
1740
- "description": "Description of the condition"
1741
- }
1742
- },
1743
- "required": [
1744
- "id"
1745
- ]
1746
- }
1747
- }
1748
- },
1749
- "required": [
1750
- "categoryId",
1751
- "conditionDescriptors"
1752
- ]
1753
- }
1754
- },
1755
- "required": [
1756
- "status",
1757
- "data"
1758
- ]
1759
- }
1760
- }
1761
- }
1762
- },
1763
- "400": {
1764
- "description": "Invalid request parameters",
1765
- "content": {
1766
- "application/json": {
1767
- "schema": {
1768
- "type": "object",
1769
- "properties": {
1770
- "error": {
1771
- "type": "string"
1772
- },
1773
- "code": {
1774
- "type": "string"
1775
- },
1776
- "details": {
1777
- "type": "array",
1778
- "items": {}
1779
- }
1780
- },
1781
- "required": [
1782
- "error",
1783
- "code"
1784
- ]
1785
- }
1786
- }
1787
- }
1788
- },
1789
- "401": {
1790
- "description": "Unauthorized - Invalid or missing eBay token",
1791
- "content": {
1792
- "application/json": {
1793
- "schema": {
1794
- "type": "object",
1795
- "properties": {
1796
- "error": {
1797
- "type": "string"
1798
- },
1799
- "code": {
1800
- "type": "string"
1801
- },
1802
- "details": {
1803
- "type": "array",
1804
- "items": {}
1805
- }
1806
- },
1807
- "required": [
1808
- "error",
1809
- "code"
1810
- ]
1811
- }
1812
- }
1813
- }
1814
- },
1815
- "403": {
1816
- "description": "Forbidden",
1817
- "content": {
1818
- "application/json": {
1819
- "schema": {
1820
- "type": "object",
1821
- "properties": {
1822
- "error": {
1823
- "type": "string"
1824
- },
1825
- "code": {
1826
- "type": "string"
1827
- },
1828
- "details": {
1829
- "type": "array",
1830
- "items": {}
1831
- }
1832
- },
1833
- "required": [
1834
- "error",
1835
- "code"
1836
- ]
1837
- }
1838
- }
1839
- }
1840
- },
1841
- "404": {
1842
- "description": "No condition policies found for the category",
1843
- "content": {
1844
- "application/json": {
1845
- "schema": {
1846
- "type": "object",
1847
- "properties": {
1848
- "error": {
1849
- "type": "string"
1850
- },
1851
- "code": {
1852
- "type": "string"
1853
- },
1854
- "details": {
1855
- "type": "array",
1856
- "items": {}
1857
- }
1858
- },
1859
- "required": [
1860
- "error",
1861
- "code"
1862
- ]
1863
- }
1864
- }
1865
- }
1866
- },
1867
- "500": {
1868
- "description": "Internal server error",
1869
- "content": {
1870
- "application/json": {
1871
- "schema": {
1872
- "type": "object",
1873
- "properties": {
1874
- "error": {
1875
- "type": "string"
1876
- },
1877
- "code": {
1878
- "type": "string"
1879
- },
1880
- "details": {
1881
- "type": "array",
1882
- "items": {}
1883
- }
1884
- },
1885
- "required": [
1886
- "error",
1887
- "code"
1888
- ]
1889
- }
1890
- }
1891
- }
1892
- }
1893
- },
1894
- "operationId": "get_api_ebay_categories_conditions_0196f1da",
1895
- "method": "get",
1896
- "path": "/api/ebay/categories/conditions/{categoryId}"
1897
- },
1898
- "API-get_api_ebay_categories_aspects_59d62e7d": {
1899
- "tags": [
1900
- "Categories"
1901
- ],
1902
- "summary": "Get category aspects",
1903
- "description": "Returns the required and optional item aspects for a specific category",
1904
- "security": [
1905
- {
1906
- "bearer": [
1907
- "https://api.ebay.com/oauth/api_scope"
1908
- ]
1909
- }
1910
- ],
1911
- "parameters": [
1912
- {
1913
- "name": "categoryId",
1914
- "in": "path",
1915
- "required": true,
1916
- "schema": {
1917
- "type": "string",
1918
- "description": "Category ID"
1919
- },
1920
- "description": "Category ID"
1921
- },
1922
- {
1923
- "name": "userId",
1924
- "in": "query",
1925
- "required": true,
1926
- "schema": {
1927
- "type": "string",
1928
- "description": "eBay user ID"
1929
- },
1930
- "description": "eBay user ID"
1931
- },
1932
- {
1933
- "name": "marketplaceId",
1934
- "in": "query",
1935
- "required": true,
1936
- "schema": {
1937
- "type": "string",
1938
- "description": "eBay marketplace ID (e.g., 'EBAY_US')"
1939
- },
1940
- "description": "eBay marketplace ID (e.g., 'EBAY_US')"
1941
- }
1942
- ],
1943
- "responses": {
1944
- "200": {
1945
- "description": "Successful response",
1946
- "content": {
1947
- "application/json": {
1948
- "schema": {
1949
- "type": "object",
1950
- "properties": {
1951
- "status": {
1952
- "type": "string",
1953
- "enum": [
1954
- "success"
1955
- ]
1956
- },
1957
- "data": {
1958
- "type": "object",
1959
- "properties": {
1960
- "aspects": {
1961
- "type": "array",
1962
- "items": {
1963
- "type": "object",
1964
- "properties": {
1965
- "localizedAspectName": {
1966
- "type": "string"
1967
- },
1968
- "aspectConstraint": {
1969
- "type": "object",
1970
- "properties": {
1971
- "aspectDataType": {
1972
- "type": "string",
1973
- "enum": [
1974
- "DATE",
1975
- "NUMBER",
1976
- "STRING",
1977
- "TEXT"
1978
- ]
1979
- },
1980
- "aspectEnabledForVariations": {
1981
- "type": "boolean"
1982
- },
1983
- "aspectFormat": {
1984
- "type": "string"
1985
- },
1986
- "aspectMaxLength": {
1987
- "type": "number"
1988
- },
1989
- "aspectMode": {
1990
- "type": "string",
1991
- "enum": [
1992
- "FREE_TEXT",
1993
- "SELECTION_ONLY"
1994
- ]
1995
- },
1996
- "aspectRequired": {
1997
- "type": "boolean"
1998
- },
1999
- "aspectUsage": {
2000
- "type": "string",
2001
- "enum": [
2002
- "RECOMMENDED",
2003
- "OPTIONAL"
2004
- ]
2005
- },
2006
- "expectedRequiredByDate": {
2007
- "type": "string"
2008
- },
2009
- "itemToAspectCardinality": {
2010
- "type": "string",
2011
- "enum": [
2012
- "MULTI",
2013
- "SINGLE"
2014
- ]
2015
- }
2016
- },
2017
- "required": [
2018
- "aspectDataType",
2019
- "aspectEnabledForVariations",
2020
- "aspectMode",
2021
- "aspectRequired",
2022
- "aspectUsage",
2023
- "itemToAspectCardinality"
2024
- ]
2025
- },
2026
- "aspectValues": {
2027
- "type": "array",
2028
- "items": {
2029
- "type": "string"
2030
- }
2031
- },
2032
- "relevanceIndicator": {
2033
- "type": "object",
2034
- "properties": {
2035
- "searchCount": {
2036
- "type": "number"
2037
- }
2038
- },
2039
- "required": [
2040
- "searchCount"
2041
- ]
2042
- }
2043
- },
2044
- "required": [
2045
- "localizedAspectName",
2046
- "aspectConstraint"
2047
- ]
2048
- }
2049
- }
2050
- },
2051
- "required": [
2052
- "aspects"
2053
- ]
2054
- }
2055
- },
2056
- "required": [
2057
- "status",
2058
- "data"
2059
- ]
2060
- }
2061
- }
2062
- }
2063
- },
2064
- "400": {
2065
- "description": "Invalid request parameters",
2066
- "content": {
2067
- "application/json": {
2068
- "schema": {
2069
- "type": "object",
2070
- "properties": {
2071
- "error": {
2072
- "type": "string"
2073
- },
2074
- "code": {
2075
- "type": "string"
2076
- },
2077
- "details": {
2078
- "type": "array",
2079
- "items": {}
2080
- }
2081
- },
2082
- "required": [
2083
- "error",
2084
- "code"
2085
- ]
2086
- }
2087
- }
2088
- }
2089
- },
2090
- "401": {
2091
- "description": "Unauthorized - Invalid or missing eBay token",
2092
- "content": {
2093
- "application/json": {
2094
- "schema": {
2095
- "type": "object",
2096
- "properties": {
2097
- "error": {
2098
- "type": "string"
2099
- },
2100
- "code": {
2101
- "type": "string"
2102
- },
2103
- "details": {
2104
- "type": "array",
2105
- "items": {}
2106
- }
2107
- },
2108
- "required": [
2109
- "error",
2110
- "code"
2111
- ]
2112
- }
2113
- }
2114
- }
2115
- },
2116
- "403": {
2117
- "description": "Forbidden",
2118
- "content": {
2119
- "application/json": {
2120
- "schema": {
2121
- "type": "object",
2122
- "properties": {
2123
- "error": {
2124
- "type": "string"
2125
- },
2126
- "code": {
2127
- "type": "string"
2128
- },
2129
- "details": {
2130
- "type": "array",
2131
- "items": {}
2132
- }
2133
- },
2134
- "required": [
2135
- "error",
2136
- "code"
2137
- ]
2138
- }
2139
- }
2140
- }
2141
- },
2142
- "404": {
2143
- "description": "No aspects found for the category",
2144
- "content": {
2145
- "application/json": {
2146
- "schema": {
2147
- "type": "object",
2148
- "properties": {
2149
- "error": {
2150
- "type": "string"
2151
- },
2152
- "code": {
2153
- "type": "string"
2154
- },
2155
- "details": {
2156
- "type": "array",
2157
- "items": {}
2158
- }
2159
- },
2160
- "required": [
2161
- "error",
2162
- "code"
2163
- ]
2164
- }
2165
- }
2166
- }
2167
- },
2168
- "500": {
2169
- "description": "Internal server error",
2170
- "content": {
2171
- "application/json": {
2172
- "schema": {
2173
- "type": "object",
2174
- "properties": {
2175
- "error": {
2176
- "type": "string"
2177
- },
2178
- "code": {
2179
- "type": "string"
2180
- },
2181
- "details": {
2182
- "type": "array",
2183
- "items": {}
2184
- }
2185
- },
2186
- "required": [
2187
- "error",
2188
- "code"
2189
- ]
2190
- }
2191
- }
2192
- }
2193
- }
2194
- },
2195
- "operationId": "get_api_ebay_categories_aspects_59d62e7d",
2196
- "method": "get",
2197
- "path": "/api/ebay/categories/{categoryId}/aspects"
2198
- },
2199
- "API-get_api_ebay_categories_listing_requirements_700b6d7f": {
2200
- "tags": [
2201
- "Categories"
2202
- ],
2203
- "summary": "Get category listing requirements",
2204
- "description": "Returns both the required/optional item aspects and allowed conditions for a specific category",
2205
- "security": [
2206
- {
2207
- "bearer": [
2208
- "https://api.ebay.com/oauth/api_scope"
2209
- ]
2210
- }
2211
- ],
2212
- "parameters": [
2213
- {
2214
- "name": "categoryId",
2215
- "in": "path",
2216
- "required": true,
2217
- "schema": {
2218
- "type": "string",
2219
- "description": "Category ID"
2220
- },
2221
- "description": "Category ID"
2222
- },
2223
- {
2224
- "name": "userId",
2225
- "in": "query",
2226
- "required": true,
2227
- "schema": {
2228
- "type": "string",
2229
- "description": "eBay user ID"
2230
- },
2231
- "description": "eBay user ID"
2232
- },
2233
- {
2234
- "name": "marketplaceId",
2235
- "in": "query",
2236
- "required": true,
2237
- "schema": {
2238
- "type": "string",
2239
- "description": "eBay marketplace ID (e.g., 'EBAY_US')"
2240
- },
2241
- "description": "eBay marketplace ID (e.g., 'EBAY_US')"
2242
- }
2243
- ],
2244
- "responses": {
2245
- "200": {
2246
- "description": "Successful response",
2247
- "content": {
2248
- "application/json": {
2249
- "schema": {
2250
- "type": "object",
2251
- "properties": {
2252
- "status": {
2253
- "type": "string",
2254
- "enum": [
2255
- "success"
2256
- ]
2257
- },
2258
- "data": {
2259
- "type": "object",
2260
- "properties": {
2261
- "categoryId": {
2262
- "oneOf": [
2263
- {
2264
- "type": "string"
2265
- },
2266
- {
2267
- "type": "number"
2268
- }
2269
- ]
2270
- },
2271
- "aspects": {
2272
- "type": "array",
2273
- "items": {
2274
- "type": "object",
2275
- "properties": {
2276
- "localizedAspectName": {
2277
- "type": "string"
2278
- },
2279
- "aspectConstraint": {
2280
- "type": "object",
2281
- "properties": {
2282
- "aspectDataType": {
2283
- "type": "string",
2284
- "enum": [
2285
- "DATE",
2286
- "NUMBER",
2287
- "STRING",
2288
- "TEXT"
2289
- ]
2290
- },
2291
- "aspectEnabledForVariations": {
2292
- "type": "boolean"
2293
- },
2294
- "aspectFormat": {
2295
- "type": "string"
2296
- },
2297
- "aspectMaxLength": {
2298
- "type": "number"
2299
- },
2300
- "aspectMode": {
2301
- "type": "string",
2302
- "enum": [
2303
- "FREE_TEXT",
2304
- "SELECTION_ONLY"
2305
- ]
2306
- },
2307
- "aspectRequired": {
2308
- "type": "boolean"
2309
- },
2310
- "aspectUsage": {
2311
- "type": "string",
2312
- "enum": [
2313
- "RECOMMENDED",
2314
- "OPTIONAL"
2315
- ]
2316
- },
2317
- "expectedRequiredByDate": {
2318
- "type": "string"
2319
- },
2320
- "itemToAspectCardinality": {
2321
- "type": "string",
2322
- "enum": [
2323
- "MULTI",
2324
- "SINGLE"
2325
- ]
2326
- }
2327
- },
2328
- "required": [
2329
- "aspectDataType",
2330
- "aspectEnabledForVariations",
2331
- "aspectMode",
2332
- "aspectRequired",
2333
- "aspectUsage",
2334
- "itemToAspectCardinality"
2335
- ]
2336
- },
2337
- "aspectValues": {
2338
- "type": "array",
2339
- "items": {
2340
- "type": "string"
2341
- }
2342
- },
2343
- "relevanceIndicator": {
2344
- "type": "object",
2345
- "properties": {
2346
- "searchCount": {
2347
- "type": "number"
2348
- }
2349
- },
2350
- "required": [
2351
- "searchCount"
2352
- ]
2353
- }
2354
- },
2355
- "required": [
2356
- "localizedAspectName",
2357
- "aspectConstraint"
2358
- ]
2359
- }
2360
- },
2361
- "conditions": {
2362
- "type": "array",
2363
- "items": {
2364
- "type": "object",
2365
- "properties": {
2366
- "id": {
2367
- "type": "string"
2368
- },
2369
- "description": {
2370
- "type": "string"
2371
- }
2372
- },
2373
- "required": [
2374
- "id"
2375
- ]
2376
- }
2377
- }
2378
- },
2379
- "required": [
2380
- "categoryId",
2381
- "aspects",
2382
- "conditions"
2383
- ]
2384
- }
2385
- },
2386
- "required": [
2387
- "status",
2388
- "data"
2389
- ]
2390
- }
2391
- }
2392
- }
2393
- },
2394
- "400": {
2395
- "description": "Invalid request parameters",
2396
- "content": {
2397
- "application/json": {
2398
- "schema": {
2399
- "type": "object",
2400
- "properties": {
2401
- "error": {
2402
- "type": "string"
2403
- },
2404
- "code": {
2405
- "type": "string"
2406
- },
2407
- "details": {
2408
- "type": "array",
2409
- "items": {}
2410
- }
2411
- },
2412
- "required": [
2413
- "error",
2414
- "code"
2415
- ]
2416
- }
2417
- }
2418
- }
2419
- },
2420
- "401": {
2421
- "description": "Unauthorized - Invalid or missing eBay token",
2422
- "content": {
2423
- "application/json": {
2424
- "schema": {
2425
- "type": "object",
2426
- "properties": {
2427
- "error": {
2428
- "type": "string"
2429
- },
2430
- "code": {
2431
- "type": "string"
2432
- },
2433
- "details": {
2434
- "type": "array",
2435
- "items": {}
2436
- }
2437
- },
2438
- "required": [
2439
- "error",
2440
- "code"
2441
- ]
2442
- }
2443
- }
2444
- }
2445
- },
2446
- "403": {
2447
- "description": "Forbidden",
2448
- "content": {
2449
- "application/json": {
2450
- "schema": {
2451
- "type": "object",
2452
- "properties": {
2453
- "error": {
2454
- "type": "string"
2455
- },
2456
- "code": {
2457
- "type": "string"
2458
- },
2459
- "details": {
2460
- "type": "array",
2461
- "items": {}
2462
- }
2463
- },
2464
- "required": [
2465
- "error",
2466
- "code"
2467
- ]
2468
- }
2469
- }
2470
- }
2471
- },
2472
- "404": {
2473
- "description": "No aspects or conditions found for the category",
2474
- "content": {
2475
- "application/json": {
2476
- "schema": {
2477
- "type": "object",
2478
- "properties": {
2479
- "error": {
2480
- "type": "string"
2481
- },
2482
- "code": {
2483
- "type": "string"
2484
- },
2485
- "details": {
2486
- "type": "array",
2487
- "items": {}
2488
- }
2489
- },
2490
- "required": [
2491
- "error",
2492
- "code"
2493
- ]
2494
- }
2495
- }
2496
- }
2497
- },
2498
- "500": {
2499
- "description": "Internal server error",
2500
- "content": {
2501
- "application/json": {
2502
- "schema": {
2503
- "type": "object",
2504
- "properties": {
2505
- "error": {
2506
- "type": "string"
2507
- },
2508
- "code": {
2509
- "type": "string"
2510
- },
2511
- "details": {
2512
- "type": "array",
2513
- "items": {}
2514
- }
2515
- },
2516
- "required": [
2517
- "error",
2518
- "code"
2519
- ]
2520
- }
2521
- }
2522
- }
2523
- }
2524
- },
2525
- "operationId": "get_api_ebay_categories_listing_requirements_700b6d7f",
2526
- "method": "get",
2527
- "path": "/api/ebay/categories/{categoryId}/listing-requirements"
2528
- },
2529
- "API-post_api_ebay_listings_auction_fe15420c": {
2530
- "tags": [
2531
- "Listings"
2532
- ],
2533
- "summary": "Create a new auction listing",
2534
- "description": "Creates a new auction listing on eBay with the specified details",
2535
- "security": [
2536
- {
2537
- "bearer": [
2538
- "https://api.ebay.com/oauth/api_scope/sell.inventory"
2539
- ]
2540
- }
2541
- ],
2542
- "parameters": [
2543
- {
2544
- "name": "userId",
2545
- "in": "query",
2546
- "required": true,
2547
- "schema": {
2548
- "type": "string",
2549
- "description": "eBay user ID"
2550
- },
2551
- "description": "eBay user ID"
2552
- }
2553
- ],
2554
- "requestBody": {
2555
- "required": true,
2556
- "content": {
2557
- "application/json": {
2558
- "schema": {
2559
- "type": "object",
2560
- "properties": {
2561
- "title": {
2562
- "type": "string",
2563
- "minLength": 1,
2564
- "maxLength": 80,
2565
- "description": "Listing title"
2566
- },
2567
- "description": {
2568
- "type": "string",
2569
- "minLength": 1,
2570
- "description": "Listing description"
2571
- },
2572
- "categoryId": {
2573
- "type": "string",
2574
- "description": "eBay category ID"
2575
- },
2576
- "conditionId": {
2577
- "type": "number",
2578
- "description": "Item condition ID"
2579
- },
2580
- "startPrice": {
2581
- "type": "number",
2582
- "exclusiveMinimum": 0,
2583
- "description": "Starting price"
2584
- },
2585
- "buyItNowPrice": {
2586
- "type": "number",
2587
- "exclusiveMinimum": 0,
2588
- "description": "Buy it now price"
2589
- },
2590
- "listingDuration": {
2591
- "default": "Days_7",
2592
- "type": "string",
2593
- "description": "Duration of the listing"
2594
- },
2595
- "shippingCost": {
2596
- "type": "number",
2597
- "minimum": 0,
2598
- "description": "Shipping cost"
2599
- },
2600
- "postalCode": {
2601
- "type": "string",
2602
- "description": "Postal code for shipping"
2603
- },
2604
- "dispatchTimeMax": {
2605
- "type": "integer",
2606
- "exclusiveMinimum": 0,
2607
- "description": "Maximum dispatch time in days"
2608
- },
2609
- "images": {
2610
- "description": "Images for the listing",
2611
- "type": "object",
2612
- "properties": {
2613
- "base64": {
2614
- "type": "array",
2615
- "items": {
2616
- "type": "string"
2617
- },
2618
- "description": "Array of base64 encoded images"
2619
- },
2620
- "urls": {
2621
- "type": "array",
2622
- "items": {
2623
- "type": "string",
2624
- "format": "uri"
2625
- },
2626
- "description": "Array of image URLs"
2627
- }
2628
- }
2629
- }
2630
- },
2631
- "required": [
2632
- "title",
2633
- "description",
2634
- "categoryId",
2635
- "startPrice",
2636
- "shippingCost",
2637
- "postalCode",
2638
- "dispatchTimeMax",
2639
- "images"
2640
- ]
2641
- }
2642
- }
2643
- }
2644
- },
2645
- "responses": {
2646
- "200": {
2647
- "description": "Successful response",
2648
- "content": {
2649
- "application/json": {
2650
- "schema": {
2651
- "discriminator": {
2652
- "propertyName": "status"
2653
- },
2654
- "oneOf": [
2655
- {
2656
- "type": "object",
2657
- "properties": {
2658
- "status": {
2659
- "type": "string",
2660
- "enum": [
2661
- "success"
2662
- ]
2663
- },
2664
- "data": {
2665
- "type": "object",
2666
- "properties": {
2667
- "itemId": {
2668
- "type": "string",
2669
- "description": "eBay item ID"
2670
- },
2671
- "title": {
2672
- "type": "string",
2673
- "description": "Listing title"
2674
- },
2675
- "startTime": {
2676
- "type": "string",
2677
- "description": "Listing start time"
2678
- },
2679
- "endTime": {
2680
- "type": "string",
2681
- "description": "Listing end time"
2682
- }
2683
- },
2684
- "required": [
2685
- "itemId",
2686
- "title",
2687
- "startTime",
2688
- "endTime"
2689
- ]
2690
- }
2691
- },
2692
- "required": [
2693
- "status",
2694
- "data"
2695
- ]
2696
- },
2697
- {
2698
- "type": "object",
2699
- "properties": {
2700
- "status": {
2701
- "type": "string",
2702
- "enum": [
2703
- "error"
2704
- ]
2705
- },
2706
- "message": {
2707
- "type": "string"
2708
- },
2709
- "errorType": {
2710
- "type": "string",
2711
- "enum": [
2712
- "VALIDATION_ERROR",
2713
- "BUSINESS_POLICIES_ERROR",
2714
- "EBAY_API_ERROR",
2715
- "AUTH_ERROR",
2716
- "INTERNAL_ERROR"
2717
- ]
2718
- },
2719
- "errors": {
2720
- "type": "array",
2721
- "items": {}
2722
- }
2723
- },
2724
- "required": [
2725
- "status",
2726
- "message",
2727
- "errorType"
2728
- ]
2729
- }
2730
- ]
2731
- }
2732
- }
2733
- }
2734
- },
2735
- "400": {
2736
- "description": "Invalid request parameters or eBay API validation error",
2737
- "content": {
2738
- "application/json": {
2739
- "schema": {
2740
- "type": "object",
2741
- "properties": {
2742
- "status": {
2743
- "type": "string",
2744
- "enum": [
2745
- "error"
2746
- ]
2747
- },
2748
- "message": {
2749
- "type": "string"
2750
- },
2751
- "errorType": {
2752
- "type": "string",
2753
- "enum": [
2754
- "VALIDATION_ERROR",
2755
- "BUSINESS_POLICIES_ERROR",
2756
- "EBAY_API_ERROR",
2757
- "AUTH_ERROR",
2758
- "INTERNAL_ERROR"
2759
- ]
2760
- },
2761
- "errors": {
2762
- "type": "array",
2763
- "items": {}
2764
- }
2765
- },
2766
- "required": [
2767
- "status",
2768
- "message",
2769
- "errorType"
2770
- ]
2771
- }
2772
- }
2773
- }
2774
- },
2775
- "401": {
2776
- "description": "Unauthorized - Invalid or missing eBay token",
2777
- "content": {
2778
- "application/json": {
2779
- "schema": {
2780
- "type": "object",
2781
- "properties": {
2782
- "error": {
2783
- "type": "string"
2784
- },
2785
- "code": {
2786
- "type": "string"
2787
- },
2788
- "details": {
2789
- "type": "array",
2790
- "items": {}
2791
- }
2792
- },
2793
- "required": [
2794
- "error",
2795
- "code"
2796
- ]
2797
- }
2798
- }
2799
- }
2800
- },
2801
- "403": {
2802
- "description": "Forbidden - Insufficient permissions or business policy error",
2803
- "content": {
2804
- "application/json": {
2805
- "schema": {
2806
- "type": "object",
2807
- "properties": {
2808
- "status": {
2809
- "type": "string",
2810
- "enum": [
2811
- "error"
2812
- ]
2813
- },
2814
- "message": {
2815
- "type": "string"
2816
- },
2817
- "errorType": {
2818
- "type": "string",
2819
- "enum": [
2820
- "VALIDATION_ERROR",
2821
- "BUSINESS_POLICIES_ERROR",
2822
- "EBAY_API_ERROR",
2823
- "AUTH_ERROR",
2824
- "INTERNAL_ERROR"
2825
- ]
2826
- },
2827
- "errors": {
2828
- "type": "array",
2829
- "items": {}
2830
- }
2831
- },
2832
- "required": [
2833
- "status",
2834
- "message",
2835
- "errorType"
2836
- ]
2837
- }
2838
- }
2839
- }
2840
- },
2841
- "500": {
2842
- "description": "Internal server error",
2843
- "content": {
2844
- "application/json": {
2845
- "schema": {
2846
- "type": "object",
2847
- "properties": {
2848
- "status": {
2849
- "type": "string",
2850
- "enum": [
2851
- "error"
2852
- ]
2853
- },
2854
- "message": {
2855
- "type": "string"
2856
- },
2857
- "errorType": {
2858
- "type": "string",
2859
- "enum": [
2860
- "VALIDATION_ERROR",
2861
- "BUSINESS_POLICIES_ERROR",
2862
- "EBAY_API_ERROR",
2863
- "AUTH_ERROR",
2864
- "INTERNAL_ERROR"
2865
- ]
2866
- },
2867
- "errors": {
2868
- "type": "array",
2869
- "items": {}
2870
- }
2871
- },
2872
- "required": [
2873
- "status",
2874
- "message",
2875
- "errorType"
2876
- ]
2877
- }
2878
- }
2879
- }
2880
- }
2881
- },
2882
- "operationId": "post_api_ebay_listings_auction_fe15420c",
2883
- "x-openai-isConsequential": false,
2884
- "method": "post",
2885
- "path": "/api/ebay/listings/auction"
2886
- },
2887
- "API-post_api_listings_advanced_1cdf2764": {
2888
- "tags": [
2889
- "Listings"
2890
- ],
2891
- "summary": "Create an advanced listing with full eBay Trading API support",
2892
- "description": "Create a new eBay listing with advanced options including shipping, returns, and condition details",
2893
- "parameters": [
2894
- {
2895
- "name": "site",
2896
- "in": "query",
2897
- "required": true,
2898
- "schema": {
2899
- "type": "string",
2900
- "description": "The eBay site ID to list on"
2901
- },
2902
- "description": "The eBay site ID to list on"
2903
- },
2904
- {
2905
- "name": "userId",
2906
- "in": "query",
2907
- "required": true,
2908
- "schema": {
2909
- "type": "string",
2910
- "description": "The eBay user ID to authenticate as"
2911
- },
2912
- "description": "The eBay user ID to authenticate as"
2913
- }
2914
- ],
2915
- "requestBody": {
2916
- "required": true,
2917
- "content": {
2918
- "application/json": {
2919
- "schema": {
2920
- "type": "object",
2921
- "properties": {
2922
- "item": {
2923
- "type": "object",
2924
- "properties": {
2925
- "title": {
2926
- "type": "string"
2927
- },
2928
- "primaryCategory": {
2929
- "type": "object",
2930
- "properties": {
2931
- "categoryId": {
2932
- "type": "string"
2933
- },
2934
- "categoryName": {
2935
- "type": "string"
2936
- }
2937
- },
2938
- "required": [
2939
- "categoryId"
2940
- ]
2941
- },
2942
- "quantity": {
2943
- "type": "integer"
2944
- },
2945
- "itemSpecifics": {
2946
- "type": "object",
2947
- "additionalProperties": {
2948
- "oneOf": [
2949
- {
2950
- "type": "string"
2951
- },
2952
- {
2953
- "type": "array",
2954
- "items": {
2955
- "type": "string"
2956
- }
2957
- }
2958
- ]
2959
- }
2960
- },
2961
- "startPrice": {
2962
- "type": "object",
2963
- "properties": {
2964
- "value": {
2965
- "type": "number"
2966
- },
2967
- "currencyId": {
2968
- "type": "string"
2969
- }
2970
- },
2971
- "required": [
2972
- "value",
2973
- "currencyId"
2974
- ]
2975
- },
2976
- "description": {
2977
- "type": "string"
2978
- },
2979
- "listingDuration": {
2980
- "type": "string"
2981
- },
2982
- "listingType": {
2983
- "type": "string"
2984
- },
2985
- "location": {
2986
- "type": "string"
2987
- },
2988
- "country": {
2989
- "type": "string"
2990
- },
2991
- "currency": {
2992
- "type": "string"
2993
- },
2994
- "paymentMethods": {
2995
- "type": "array",
2996
- "items": {
2997
- "type": "string"
2998
- }
2999
- },
3000
- "dispatchTimeMax": {
3001
- "default": 3,
3002
- "type": "integer"
3003
- },
3004
- "pictureDetails": {
3005
- "type": "object",
3006
- "properties": {
3007
- "galleryType": {
3008
- "type": "string"
3009
- },
3010
- "pictureUrl": {
3011
- "type": "array",
3012
- "items": {
3013
- "type": "string",
3014
- "format": "uri"
3015
- }
3016
- }
3017
- },
3018
- "required": [
3019
- "galleryType"
3020
- ]
3021
- },
3022
- "returnPolicy": {
3023
- "type": "object",
3024
- "properties": {
3025
- "returnsAcceptedOption": {
3026
- "type": "string",
3027
- "enum": [
3028
- "ReturnsAccepted",
3029
- "ReturnsNotAccepted"
3030
- ]
3031
- },
3032
- "returnsWithinOption": {
3033
- "type": "string"
3034
- },
3035
- "description": {
3036
- "type": "string"
3037
- }
3038
- },
3039
- "required": [
3040
- "returnsAcceptedOption",
3041
- "description"
3042
- ]
3043
- },
3044
- "shippingDetails": {
3045
- "type": "object",
3046
- "properties": {
3047
- "shippingType": {
3048
- "type": "string"
3049
- },
3050
- "shippingServiceOptions": {
3051
- "type": "array",
3052
- "items": {
3053
- "type": "object",
3054
- "properties": {
3055
- "shippingService": {
3056
- "type": "string"
3057
- },
3058
- "shippingServiceCost": {
3059
- "type": "object",
3060
- "properties": {
3061
- "value": {
3062
- "type": "number"
3063
- },
3064
- "currencyId": {
3065
- "type": "string"
3066
- }
3067
- },
3068
- "required": [
3069
- "value",
3070
- "currencyId"
3071
- ]
3072
- },
3073
- "freeShipping": {
3074
- "type": "boolean"
3075
- }
3076
- },
3077
- "required": [
3078
- "shippingService"
3079
- ]
3080
- }
3081
- }
3082
- },
3083
- "required": [
3084
- "shippingType",
3085
- "shippingServiceOptions"
3086
- ]
3087
- },
3088
- "conditionId": {
3089
- "type": "integer"
3090
- },
3091
- "conditionDescription": {
3092
- "type": "string"
3093
- }
3094
- },
3095
- "required": [
3096
- "title",
3097
- "primaryCategory",
3098
- "quantity",
3099
- "startPrice",
3100
- "location"
3101
- ]
3102
- },
3103
- "errorLanguage": {
3104
- "type": "string"
3105
- },
3106
- "warningLevel": {
3107
- "type": "string"
3108
- }
3109
- },
3110
- "required": [
3111
- "item"
3112
- ]
3113
- }
3114
- }
3115
- }
3116
- },
3117
- "responses": {
3118
- "200": {
3119
- "description": "Successful response",
3120
- "content": {
3121
- "application/json": {
3122
- "schema": {
3123
- "type": "object",
3124
- "properties": {
3125
- "itemId": {
3126
- "type": "string"
3127
- },
3128
- "startTime": {
3129
- "type": "string"
3130
- },
3131
- "endTime": {
3132
- "type": "string"
3133
- },
3134
- "fees": {
3135
- "type": "array",
3136
- "items": {
3137
- "type": "object",
3138
- "properties": {
3139
- "name": {
3140
- "type": "string"
3141
- },
3142
- "fee": {
3143
- "type": "object",
3144
- "properties": {
3145
- "value": {
3146
- "type": "number"
3147
- },
3148
- "currencyId": {
3149
- "type": "string"
3150
- }
3151
- },
3152
- "required": [
3153
- "value",
3154
- "currencyId"
3155
- ]
3156
- }
3157
- },
3158
- "required": [
3159
- "name",
3160
- "fee"
3161
- ]
3162
- }
3163
- },
3164
- "category": {
3165
- "type": "object",
3166
- "properties": {
3167
- "categoryId": {
3168
- "type": "string"
3169
- },
3170
- "categoryName": {
3171
- "type": "string"
3172
- }
3173
- },
3174
- "required": [
3175
- "categoryId"
3176
- ]
3177
- },
3178
- "message": {
3179
- "type": "string"
3180
- }
3181
- },
3182
- "required": [
3183
- "itemId",
3184
- "startTime",
3185
- "endTime",
3186
- "fees",
3187
- "category",
3188
- "message"
3189
- ]
3190
- }
3191
- }
3192
- }
3193
- },
3194
- "400": {
3195
- "description": "Invalid request parameters or eBay API validation error",
3196
- "content": {
3197
- "application/json": {
3198
- "schema": {
3199
- "type": "object",
3200
- "properties": {
3201
- "status": {
3202
- "type": "string",
3203
- "enum": [
3204
- "error"
3205
- ]
3206
- },
3207
- "message": {
3208
- "type": "string"
3209
- },
3210
- "details": {
3211
- "type": "string"
3212
- },
3213
- "errorType": {
3214
- "type": "string",
3215
- "enum": [
3216
- "VALIDATION_ERROR",
3217
- "BUSINESS_POLICIES_ERROR",
3218
- "EBAY_API_ERROR",
3219
- "AUTH_ERROR",
3220
- "INTERNAL_ERROR"
3221
- ]
3222
- },
3223
- "errors": {
3224
- "type": "array",
3225
- "items": {
3226
- "type": "object",
3227
- "properties": {
3228
- "code": {
3229
- "oneOf": [
3230
- {
3231
- "type": "string"
3232
- },
3233
- {
3234
- "type": "number"
3235
- }
3236
- ]
3237
- },
3238
- "message": {
3239
- "type": "string"
3240
- },
3241
- "severity": {
3242
- "type": "string"
3243
- },
3244
- "classification": {
3245
- "type": "string"
3246
- }
3247
- },
3248
- "required": [
3249
- "code",
3250
- "message"
3251
- ]
3252
- }
3253
- }
3254
- },
3255
- "required": [
3256
- "status",
3257
- "message",
3258
- "errorType"
3259
- ]
3260
- }
3261
- }
3262
- }
3263
- },
3264
- "401": {
3265
- "description": "Unauthorized - Invalid or missing eBay token",
3266
- "content": {
3267
- "application/json": {
3268
- "schema": {
3269
- "type": "object",
3270
- "properties": {
3271
- "status": {
3272
- "type": "string",
3273
- "enum": [
3274
- "error"
3275
- ]
3276
- },
3277
- "message": {
3278
- "type": "string"
3279
- },
3280
- "details": {
3281
- "type": "string"
3282
- },
3283
- "errorType": {
3284
- "type": "string",
3285
- "enum": [
3286
- "VALIDATION_ERROR",
3287
- "BUSINESS_POLICIES_ERROR",
3288
- "EBAY_API_ERROR",
3289
- "AUTH_ERROR",
3290
- "INTERNAL_ERROR"
3291
- ]
3292
- },
3293
- "errors": {
3294
- "type": "array",
3295
- "items": {
3296
- "type": "object",
3297
- "properties": {
3298
- "code": {
3299
- "oneOf": [
3300
- {
3301
- "type": "string"
3302
- },
3303
- {
3304
- "type": "number"
3305
- }
3306
- ]
3307
- },
3308
- "message": {
3309
- "type": "string"
3310
- },
3311
- "severity": {
3312
- "type": "string"
3313
- },
3314
- "classification": {
3315
- "type": "string"
3316
- }
3317
- },
3318
- "required": [
3319
- "code",
3320
- "message"
3321
- ]
3322
- }
3323
- }
3324
- },
3325
- "required": [
3326
- "status",
3327
- "message",
3328
- "errorType"
3329
- ]
3330
- }
3331
- }
3332
- }
3333
- },
3334
- "403": {
3335
- "description": "Forbidden - Insufficient permissions or business policy error",
3336
- "content": {
3337
- "application/json": {
3338
- "schema": {
3339
- "type": "object",
3340
- "properties": {
3341
- "status": {
3342
- "type": "string",
3343
- "enum": [
3344
- "error"
3345
- ]
3346
- },
3347
- "message": {
3348
- "type": "string"
3349
- },
3350
- "details": {
3351
- "type": "string"
3352
- },
3353
- "errorType": {
3354
- "type": "string",
3355
- "enum": [
3356
- "VALIDATION_ERROR",
3357
- "BUSINESS_POLICIES_ERROR",
3358
- "EBAY_API_ERROR",
3359
- "AUTH_ERROR",
3360
- "INTERNAL_ERROR"
3361
- ]
3362
- },
3363
- "errors": {
3364
- "type": "array",
3365
- "items": {
3366
- "type": "object",
3367
- "properties": {
3368
- "code": {
3369
- "oneOf": [
3370
- {
3371
- "type": "string"
3372
- },
3373
- {
3374
- "type": "number"
3375
- }
3376
- ]
3377
- },
3378
- "message": {
3379
- "type": "string"
3380
- },
3381
- "severity": {
3382
- "type": "string"
3383
- },
3384
- "classification": {
3385
- "type": "string"
3386
- }
3387
- },
3388
- "required": [
3389
- "code",
3390
- "message"
3391
- ]
3392
- }
3393
- }
3394
- },
3395
- "required": [
3396
- "status",
3397
- "message",
3398
- "errorType"
3399
- ]
3400
- }
3401
- }
3402
- }
3403
- },
3404
- "500": {
3405
- "description": "Internal server error",
3406
- "content": {
3407
- "application/json": {
3408
- "schema": {
3409
- "type": "object",
3410
- "properties": {
3411
- "status": {
3412
- "type": "string",
3413
- "enum": [
3414
- "error"
3415
- ]
3416
- },
3417
- "message": {
3418
- "type": "string"
3419
- },
3420
- "details": {
3421
- "type": "string"
3422
- },
3423
- "errorType": {
3424
- "type": "string",
3425
- "enum": [
3426
- "VALIDATION_ERROR",
3427
- "BUSINESS_POLICIES_ERROR",
3428
- "EBAY_API_ERROR",
3429
- "AUTH_ERROR",
3430
- "INTERNAL_ERROR"
3431
- ]
3432
- },
3433
- "errors": {
3434
- "type": "array",
3435
- "items": {
3436
- "type": "object",
3437
- "properties": {
3438
- "code": {
3439
- "oneOf": [
3440
- {
3441
- "type": "string"
3442
- },
3443
- {
3444
- "type": "number"
3445
- }
3446
- ]
3447
- },
3448
- "message": {
3449
- "type": "string"
3450
- },
3451
- "severity": {
3452
- "type": "string"
3453
- },
3454
- "classification": {
3455
- "type": "string"
3456
- }
3457
- },
3458
- "required": [
3459
- "code",
3460
- "message"
3461
- ]
3462
- }
3463
- }
3464
- },
3465
- "required": [
3466
- "status",
3467
- "message",
3468
- "errorType"
3469
- ]
3470
- }
3471
- }
3472
- }
3473
- }
3474
- },
3475
- "operationId": "post_api_listings_advanced_1cdf2764",
3476
- "x-openai-isConsequential": false,
3477
- "method": "post",
3478
- "path": "/api/listings/advanced"
3479
- },
3480
- "API-post_api_images_upload_830cd0c4": {
3481
- "tags": [
3482
- "Images"
3483
- ],
3484
- "summary": "Upload multiple images",
3485
- "description": "Upload one or more images using multipart/form-data. Accepts up to 12 image files (JPEG, PNG, GIF, WebP) with a maximum size of 5MB each. Use field name 'images' for the file uploads.",
3486
- "parameters": [],
3487
- "requestBody": {
3488
- "required": true,
3489
- "content": {
3490
- "multipart/form-data": {
3491
- "schema": {
3492
- "type": "object",
3493
- "properties": {
3494
- "images": {
3495
- "type": "array",
3496
- "items": {
3497
- "type": "string",
3498
- "format": "binary"
3499
- },
3500
- "description": "Image files to upload. Supports JPEG, PNG, GIF, and WebP formats. Maximum 12 files, each up to 5MB."
3501
- }
3502
- },
3503
- "required": [
3504
- "images"
3505
- ]
3506
- }
3507
- }
3508
- }
3509
- },
3510
- "responses": {
3511
- "200": {
3512
- "description": "Successful response",
3513
- "content": {
3514
- "application/json": {
3515
- "schema": {
3516
- "discriminator": {
3517
- "propertyName": "status"
3518
- },
3519
- "oneOf": [
3520
- {
3521
- "type": "object",
3522
- "properties": {
3523
- "status": {
3524
- "type": "string",
3525
- "enum": [
3526
- "success"
3527
- ]
3528
- },
3529
- "data": {
3530
- "type": "object",
3531
- "properties": {
3532
- "urls": {
3533
- "type": "array",
3534
- "items": {
3535
- "type": "string",
3536
- "format": "uri"
3537
- },
3538
- "description": "URLs of the uploaded images"
3539
- }
3540
- },
3541
- "required": [
3542
- "urls"
3543
- ]
3544
- }
3545
- },
3546
- "required": [
3547
- "status",
3548
- "data"
3549
- ]
3550
- },
3551
- {
3552
- "type": "object",
3553
- "properties": {
3554
- "status": {
3555
- "type": "string",
3556
- "enum": [
3557
- "error"
3558
- ]
3559
- },
3560
- "message": {
3561
- "type": "string"
3562
- },
3563
- "errorType": {
3564
- "type": "string",
3565
- "enum": [
3566
- "VALIDATION_ERROR",
3567
- "UPLOAD_ERROR",
3568
- "INTERNAL_ERROR"
3569
- ]
3570
- }
3571
- },
3572
- "required": [
3573
- "status",
3574
- "message",
3575
- "errorType"
3576
- ]
3577
- }
3578
- ]
3579
- }
3580
- }
3581
- }
3582
- },
3583
- "400": {
3584
- "description": "Invalid request parameters or file validation error",
3585
- "content": {
3586
- "application/json": {
3587
- "schema": {
3588
- "type": "object",
3589
- "properties": {
3590
- "status": {
3591
- "type": "string",
3592
- "enum": [
3593
- "error"
3594
- ]
3595
- },
3596
- "message": {
3597
- "type": "string"
3598
- },
3599
- "errorType": {
3600
- "type": "string",
3601
- "enum": [
3602
- "VALIDATION_ERROR",
3603
- "UPLOAD_ERROR",
3604
- "INTERNAL_ERROR"
3605
- ]
3606
- }
3607
- },
3608
- "required": [
3609
- "status",
3610
- "message",
3611
- "errorType"
3612
- ]
3613
- }
3614
- }
3615
- }
3616
- },
3617
- "401": {
3618
- "description": "Unauthorized",
3619
- "content": {
3620
- "application/json": {
3621
- "schema": {
3622
- "type": "object",
3623
- "properties": {
3624
- "error": {
3625
- "type": "string"
3626
- },
3627
- "code": {
3628
- "type": "string"
3629
- },
3630
- "details": {
3631
- "type": "array",
3632
- "items": {}
3633
- }
3634
- },
3635
- "required": [
3636
- "error",
3637
- "code"
3638
- ]
3639
- }
3640
- }
3641
- }
3642
- },
3643
- "403": {
3644
- "description": "Forbidden",
3645
- "content": {
3646
- "application/json": {
3647
- "schema": {
3648
- "type": "object",
3649
- "properties": {
3650
- "error": {
3651
- "type": "string"
3652
- },
3653
- "code": {
3654
- "type": "string"
3655
- },
3656
- "details": {
3657
- "type": "array",
3658
- "items": {}
3659
- }
3660
- },
3661
- "required": [
3662
- "error",
3663
- "code"
3664
- ]
3665
- }
3666
- }
3667
- }
3668
- },
3669
- "500": {
3670
- "description": "Internal server error",
3671
- "content": {
3672
- "application/json": {
3673
- "schema": {
3674
- "type": "object",
3675
- "properties": {
3676
- "status": {
3677
- "type": "string",
3678
- "enum": [
3679
- "error"
3680
- ]
3681
- },
3682
- "message": {
3683
- "type": "string"
3684
- },
3685
- "errorType": {
3686
- "type": "string",
3687
- "enum": [
3688
- "VALIDATION_ERROR",
3689
- "UPLOAD_ERROR",
3690
- "INTERNAL_ERROR"
3691
- ]
3692
- }
3693
- },
3694
- "required": [
3695
- "status",
3696
- "message",
3697
- "errorType"
3698
- ]
3699
- }
3700
- }
3701
- }
3702
- }
3703
- },
3704
- "operationId": "post_api_images_upload_830cd0c4",
3705
- "x-openai-isConsequential": false,
3706
- "method": "post",
3707
- "path": "/api/images/upload"
3708
- }
3709
- }
3710
- }