الكتالوج / API v1
قائمة المنتجات
/api/partner/v1/productsInvalid or duplicate SKUs are omitted before pagination. Totals count eligible products; an empty catalog returns 200 with an empty list.
Authorization: Bearer <PARTNER_API_KEY>
معاملات الاستعلام
pageintegerاختياريdefault: 1 · min: 1
sizeintegerاختياريdefault: 20 · min: 1 · max: 100
searchstringاختياريmax length: 100
الاستجابة
Current visible, available, allowed partner catalog.
dataobjectمطلوبعرض الحقول
itemsarrayمطلوبعرض الحقول
skustringمطلوبmax length: 100
nameArstringمطلوبnameEnstringمطلوبhowToUseArstringمطلوبhowToUseEnstringمطلوبimagestring | nullمطلوبmerchantobjectمطلوبعرض الحقول
idstringمطلوبnameArstringمطلوبnameEnstringمطلوب
categoryobjectمطلوبعرض الحقول
idstringمطلوبnameArstringمطلوبnameEnstringمطلوب
faceValuestring | nullمطلوبOriginal provider denomination when supplied. SKU-only OneCard products may return null; it is never inferred from the SAR price.
faceValueCurrencystring | nullمطلوبPaired with faceValue; both fields are null when denomination metadata is unavailable.
min length: 3 · max length: 3
priceMinorintegerمطلوبFinal VAT-inclusive gross SAR unit price, excluding any service fee, from configured partner pricing or, for partners not yet migrated, a legacy override or retail fallback.
int64 · min: 1 · max: 9007199254740991
priceCurrencystringمطلوب"SAR"
priceSourcestringمطلوب"PARTNER_PRICE" · "RETAIL_FALLBACK"
redemptionChannelstringمطلوب"MERCHANT" · "GIFTU_APP"
paginationobjectمطلوبعرض الحقول
pageintegerمطلوبsizeintegerمطلوبtotalintegerمطلوبint64
totalPagesintegerمطلوب
requestIdstringمطلوبerrorobject | nullمطلوبnull