SelSup Developers

Halk API · API İpucu

Yarışmacılar

Rekabetçiler için kesin yollar, parametreler, talep kurumları ve genişletilenebilir cevap sistemleri dahil olmak üzere son noktalar.

Son noktaları: 12/api/competitorDayanıklıMakine okuyabilir açıklama ↗
{ }

Bu sayfa düzenlenebilir bir bağımsız sözleşme ile desteklenir.

/api/competitor

Kullanılabilir iş akışları

Kullanılabilir iş akışları

01

Yarışmacıları kullanmaya başlayın

Özel bir API token kullanın ve önce test verileri ile okuma işlemlerini doğrulayın.

  1. Token sunucu tarafında tut ve Authorization başlığı gönder.
  2. Gerekli parametreleri kontrol edin ve istek veya yanıt şeması genişletin.
  3. Uygulama hatalarında HTTP durumunu ve sabit error alanını ele alın.

Verim modeli

Veriler yapısı

Modeller burada bir kez listelenmiştir ve bunları kullanan uç noktalardan doğrudan genişletilebilir.

Competitor10 alanlar
idinteger · int64

Id.

read-only
modelIdinteger · int64

Model kimliği.

productIdinteger · int64

Ürün Kimliği.

servicestring

Hizmet.

Zorunlu
urlstring

- Urt.

Zorunlu
serviceIdstring

Hizmet Kimliği.

clientIdinteger · int64

Müşteri kimliği.

read-only
latestPricenumber · double

En son fiyat.

read-only
currencystring

Para birimi.

read-only
latestPriceDatestring · date-time

En son fiyat tarihini.

read-only
CompetitorPrice6 alanlar
idinteger · int64

Id.

read-only
competitorIdinteger · int64

Yarışmacı kimliği.

Zorunlu
clientIdinteger · int64

Müşteri kimliği.

read-only
pricenumber · double

- Fiyat.

Zorunlu
currencystring

Para birimi.

datestring · date-time

- Randevu.

CompetitorImportResult2 alanlar
importedinteger · int32

İçe aktarılmış.

skippedinteger · int32

Atladın.

Hata sözleşmesi

Uygulama hataları nasıl iade edilir

error kodu her yerde aynıdır, kullanıcıya yönelik mesaj ise sunucu tarafından tercüme edilir. error etrafında uygulama mantığı oluşturun ve localMessage'i yalnızca görüntülemek için kullanın.

error

Entegre mantığı için sabit makine okunur kod.

localMessage

API token kullanıcısının dilinde görüntülemeye hazır mesaj.

params

Sunucu tarafından yerel mesaj şablonuna girilen değerler.

文

localMessage, API tokenine sahip olan kullanıcının lang alanını kullanır. Belgeleme dili ve Accept-Language başlığı değiştirmez; kullanıcıya dil yapılandırılmadığında Rusça kullanılır.

RUKullanıcı yerel ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
TRTürkçe (tr)
{
  "error": "error_brand_already_exists",
  "localMessage": "Base markası zaten mevcut",
  "params": {
    "name": "Base"
  }
}

Son noktaları

Son noktaları

PUT

Güncelleme

/api/competitor/{competitorId}
Yazma erişimli işaretleme

PUT /api/competitor/{competitorId}. kullanarak güncelleme

Yol parametreleri

AlanTürZorunluAçıklama
competitorId integer · int64 Evet Yarışmacı kimliği.

İstekçi organ

application/json
Nesne alanlarıCompetitor
AlanTürZorunluAçıklama
id integer · int64 Hayır Id.
modelId integer · int64 Hayır Model kimliği.
productId integer · int64 Hayır Ürün Kimliği.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Evet Hizmet.
url string Evet - Urt.
serviceId string Hayır Hizmet Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
latestPrice number · double Hayır En son fiyat.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Hayır Para birimi.
latestPriceDate string · date-time Hayır En son fiyat tarihini.
curl --request PUT 'https://api.selsup.ru/api/competitor/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "productId": 1001,
  "serviceId": "string"
}'

Başarılı tepki

200

Cevapın bir vücudu yok.

Hatalar10

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required
Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied
Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown
Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

400error_cant_extract_tariffs
Tarifeler alınamıyor. Destek birimine yazın

Uygulama mantığında sabit error_cant_extract_tariffs kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_id_required
Rakip id'si gerekiyor

Uygulama mantığında sabit error_competitor_id_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_not_found
Rakip bulunamadi

Uygulama mantığında sabit error_competitor_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_required
Rakip zorunludur

Uygulama mantığında sabit error_competitor_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_url_required
Rakip bağlantısı zorunludur

Uygulama mantığında sabit error_competitor_url_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client
Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_service_not_supported
Сервис не поддерживается

Uygulama mantığında sabit error_service_not_supported kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

DELETE

Sil

/api/competitor/{competitorId}
Yazma erişimli işaretleme

DELETE /api/competitor/{competitorId}. kullanarak sil

Yol parametreleri

AlanTürZorunluAçıklama
competitorId integer · int64 Evet Yarışmacı kimliği.
curl --request DELETE 'https://api.selsup.ru/api/competitor/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Başarılı tepki

200

Cevapın bir vücudu yok.

Hatalar7

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required
Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied
Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown
Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

400error_cant_extract_tariffs
Tarifeler alınamıyor. Destek birimine yazın

Uygulama mantığında sabit error_cant_extract_tariffs kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_id_required
Rakip id'si gerekiyor

Uygulama mantığında sabit error_competitor_id_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_not_found
Rakip bulunamadi

Uygulama mantığında sabit error_competitor_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client
Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

GET

Hepsini al .

/api/competitor/{modelId}
Okuma erişimi olan işaret

GET /api/competitor/{modelId}. ile Her şeyi elde edin

Yol parametreleri

AlanTürZorunluAçıklama
modelId integer · int64 Evet Model kimliği.
curl --request GET 'https://api.selsup.ru/api/competitor/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Başarılı tepki

200
Array öğesi yapısı Competitor[]
AlanTürZorunluAçıklama
id integer · int64 Hayır Id.
modelId integer · int64 Hayır Model kimliği.
productId integer · int64 Hayır Ürün Kimliği.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Evet Hizmet.
url string Evet - Urt.
serviceId string Hayır Hizmet Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
latestPrice number · double Hayır En son fiyat.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Hayır Para birimi.
latestPriceDate string · date-time Hayır En son fiyat tarihini.
[
  "string"
]
Hatalar6

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required
Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied
Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown
Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

400error_cant_extract_tariffs
Tarifeler alınamıyor. Destek birimine yazın

Uygulama mantığında sabit error_cant_extract_tariffs kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_model_id_required
Model kimliği gerekiyor

Uygulama mantığında sabit error_model_id_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client
Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

POST

Yaratmak

/api/competitor/{modelId}
Yazma erişimli işaretleme

POST /api/competitor/{modelId}. kullanarak oluştur

Yol parametreleri

AlanTürZorunluAçıklama
modelId integer · int64 Evet Model kimliği.

İstekçi organ

application/json
Nesne alanlarıCompetitor
AlanTürZorunluAçıklama
id integer · int64 Hayır Id.
modelId integer · int64 Hayır Model kimliği.
productId integer · int64 Hayır Ürün Kimliği.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Evet Hizmet.
url string Evet - Urt.
serviceId string Hayır Hizmet Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
latestPrice number · double Hayır En son fiyat.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Hayır Para birimi.
latestPriceDate string · date-time Hayır En son fiyat tarihini.
curl --request POST 'https://api.selsup.ru/api/competitor/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "productId": 1001,
  "serviceId": "string"
}'

Başarılı tepki

200
Nesne alanları Competitor
AlanTürZorunluAçıklama
id integer · int64 Hayır Id.
modelId integer · int64 Hayır Model kimliği.
productId integer · int64 Hayır Ürün Kimliği.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Evet Hizmet.
url string Evet - Urt.
serviceId string Hayır Hizmet Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
latestPrice number · double Hayır En son fiyat.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Hayır Para birimi.
latestPriceDate string · date-time Hayır En son fiyat tarihini.
{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "productId": 1001,
  "serviceId": "string"
}
Hatalar8

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required
Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied
Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown
Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

400error_cant_extract_tariffs
Tarifeler alınamıyor. Destek birimine yazın

Uygulama mantığında sabit error_cant_extract_tariffs kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_required
Rakip zorunludur

Uygulama mantığında sabit error_competitor_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_url_required
Rakip bağlantısı zorunludur

Uygulama mantığında sabit error_competitor_url_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client
Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_service_not_supported
Сервис не поддерживается

Uygulama mantığında sabit error_service_not_supported kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

GET

Ürünleri Bul

/api/competitor/product/{productId}
Okuma erişimi olan işaret

GET /api/competitor/product/{productId}. ile ürünleri alın

Yol parametreleri

AlanTürZorunluAçıklama
productId integer · int64 Evet Ürün Kimliği.
curl --request GET 'https://api.selsup.ru/api/competitor/product/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Başarılı tepki

200
Array öğesi yapısı Competitor[]
AlanTürZorunluAçıklama
id integer · int64 Hayır Id.
modelId integer · int64 Hayır Model kimliği.
productId integer · int64 Hayır Ürün Kimliği.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Evet Hizmet.
url string Evet - Urt.
serviceId string Hayır Hizmet Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
latestPrice number · double Hayır En son fiyat.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Hayır Para birimi.
latestPriceDate string · date-time Hayır En son fiyat tarihini.
[
  "string"
]
Hatalar6

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required
Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied
Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown
Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

400error_cant_extract_tariffs
Tarifeler alınamıyor. Destek birimine yazın

Uygulama mantığında sabit error_cant_extract_tariffs kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client
Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_product_not_found
Ürün bulunamadı

Uygulama mantığında sabit error_product_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

POST

Ürün için yarat

/api/competitor/product/{productId}
Yazma erişimli işaretleme

POST /api/competitor/product/{productId}. kullanarak ürün için oluştur

Yol parametreleri

AlanTürZorunluAçıklama
productId integer · int64 Evet Ürün Kimliği.

İstekçi organ

application/json
Nesne alanlarıCompetitor
AlanTürZorunluAçıklama
id integer · int64 Hayır Id.
modelId integer · int64 Hayır Model kimliği.
productId integer · int64 Hayır Ürün Kimliği.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Evet Hizmet.
url string Evet - Urt.
serviceId string Hayır Hizmet Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
latestPrice number · double Hayır En son fiyat.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Hayır Para birimi.
latestPriceDate string · date-time Hayır En son fiyat tarihini.
curl --request POST 'https://api.selsup.ru/api/competitor/product/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "productId": 1001,
  "serviceId": "string"
}'

Başarılı tepki

200
Nesne alanları Competitor
AlanTürZorunluAçıklama
id integer · int64 Hayır Id.
modelId integer · int64 Hayır Model kimliği.
productId integer · int64 Hayır Ürün Kimliği.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Evet Hizmet.
url string Evet - Urt.
serviceId string Hayır Hizmet Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
latestPrice number · double Hayır En son fiyat.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Hayır Para birimi.
latestPriceDate string · date-time Hayır En son fiyat tarihini.
{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "productId": 1001,
  "serviceId": "string"
}
Hatalar9

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required
Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied
Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown
Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

400error_cant_extract_tariffs
Tarifeler alınamıyor. Destek birimine yazın

Uygulama mantığında sabit error_cant_extract_tariffs kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_required
Rakip zorunludur

Uygulama mantığında sabit error_competitor_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_url_required
Rakip bağlantısı zorunludur

Uygulama mantığında sabit error_competitor_url_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client
Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_product_not_found
Ürün bulunamadı

Uygulama mantığında sabit error_product_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_service_not_supported
Сервис не поддерживается

Uygulama mantığında sabit error_service_not_supported kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

POST

Fiyatlar Oluştur

/api/competitor/price/batch
Yazma erişimli işaretleme

POST /api/competitor/price/batch. kullanarak Fiyatlar oluştur

İstekçi organ

application/json
Array öğesi yapısıCompetitorPrice[]
AlanTürZorunluAçıklama
id integer · int64 Hayır Id.
competitorId integer · int64 Evet Yarışmacı kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
price number · double Evet - Fiyat.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Hayır Para birimi.
date string · date-time Hayır - Randevu.
curl --request POST 'https://api.selsup.ru/api/competitor/price/batch' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '[
  "string"
]'

Başarılı tepki

200
1
Hatalar9

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required
Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied
Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown
Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

400error_cant_extract_tariffs
Tarifeler alınamıyor. Destek birimine yazın

Uygulama mantığında sabit error_cant_extract_tariffs kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_id_required
Rakip id'si gerekiyor

Uygulama mantığında sabit error_competitor_id_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_not_found
Rakip bulunamadi

Uygulama mantığında sabit error_competitor_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_price_required
Gecerli bir rakip fiyati girin

Uygulama mantığında sabit error_competitor_price_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_prices_required
Rakip fiyatlari gereklidir

Uygulama mantığında sabit error_competitor_prices_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client
Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

POST

İndirim Rekabetçileri

/api/competitor/import
Yazma erişimli işaretleme

POST /api/competitor/import. kullanan ithal rakipleri

İstekçi organ

multipart/form-data
AlanTürZorunluAçıklama
file string · binary Evet Dosya.
curl --request POST 'https://api.selsup.ru/api/competitor/import' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --form 'file=@./file.bin'

Başarılı tepki

200
Nesne alanları CompetitorImportResult
AlanTürZorunluAçıklama
imported integer · int32 Hayır İçe aktarılmış.
skipped integer · int32 Hayır Atladın.
{
  "imported": 1,
  "skipped": 1
}
Hatalar23

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required
Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied
Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown
Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

400error_base_creating
Hesabınız oluşturulma aşamasında, hesabın tamamen oluşturulması için birkaç dakika bekleyin

Uygulama mantığında sabit error_base_creating kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_cabinet_access_denied
Bu çalışma alanına erişilemiyor.

Uygulama mantığında sabit error_cabinet_access_denied kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_cant_extract_tariffs
Tarifeler alınamıyor. Destek birimine yazın

Uygulama mantığında sabit error_cant_extract_tariffs kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_required
Rakip zorunludur

Uygulama mantığında sabit error_competitor_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_competitor_url_required
Rakip bağlantısı zorunludur

Uygulama mantığında sabit error_competitor_url_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_empty_organization_form
organizasyon formu belirtilmemiş

Uygulama mantığında sabit error_empty_organization_form kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_empty_organization_inn
Organizasyon vergi numarası belirtilmemiş

Uygulama mantığında sabit error_empty_organization_inn kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_empty_organization_name
Kuruluş adı belirtilmemiş

Uygulama mantığında sabit error_empty_organization_name kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_fulfillment_client_access_denied
Fulfillment client access denied

Uygulama mantığında sabit error_fulfillment_client_access_denied kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_fulfillment_client_contract_required
İşlemlere erişmek i\xe7in s\xf6zleşmeyi kabul edin.

Uygulama mantığında sabit error_fulfillment_client_contract_required kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_incorrect_excel
Geçersiz dosya formatı. Excel tablosu yükleyin.

Uygulama mantığında sabit error_incorrect_excel kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_max_page
Sayfa numarası 100.000'den büyük olamaz

Uygulama mantığında sabit error_max_page kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_max_upload_size_exceeded
İzin verilen dosya boyutu aşıldı

Uygulama mantığında sabit error_max_upload_size_exceeded kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client
Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_organization_create_failed
Kuruluş oluşturulurken bir sorun oluştu. Lütfen destekle iletişime geçin

Uygulama mantığında sabit error_organization_create_failed kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_organization_exists
Organizasyon zaten oluşturulmuş

Uygulama mantığında sabit error_organization_exists kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_products_not_found
Şu ürünler bulunamadı: {products}

Uygulama mantığında sabit error_products_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_reload
Yetkilendirme oturumu sona erdi, tarayıcı sayfasını yenileyin. Yenileme işe yaramazsa, site için çerezleri silmeyi deneyin

Uygulama mantığında sabit error_reload kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_service_not_supported
Сервис не поддерживается

Uygulama mantığında sabit error_service_not_supported kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_wrong_inn
Organizasyon TIN numarası hatalı belirtilmiş, uzunluk 10 veya 12 basamak olmalıdır

Uygulama mantığında sabit error_wrong_inn kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

GET

Fiyatları Al

/api/competitor/{competitorId}/price
Okuma erişimi olan işaret

GET /api/competitor/{competitorId}/price. kullanarak Fiyatlar Al

Yol parametreleri

AlanTürZorunluAçıklama
competitorId integer · int64 Evet Yarışmacı kimliği.

Sorgulama parametreleri

AlanTürZorunluAçıklama
dateFrom string · date-time Hayır Tarihden.
dateTo string · date-time Hayır Tarih için.
curl --request GET 'https://api.selsup.ru/api/competitor/1001/price' \
  --header 'Authorization: YOUR_API_TOKEN'

Başarılı tepki

200
Array öğesi yapısı CompetitorPrice[]
AlanTürZorunluAçıklama
id integer · int64 Hayır Id.
competitorId integer · int64 Evet Yarışmacı kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
price number · double Evet - Fiyat.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Hayır Para birimi.
date string · date-time Hayır - Randevu.
[
  "string"
]
Hatalar3

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required
Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied
Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown
Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

GET

Şablon alın

/api/competitor/template
Okuma erişimi olan işaret

GET /api/competitor/template. kullanarak Şablon alın

Sorgulama parametreleri

AlanTürZorunluAçıklama
organizationId integer · int64 Hayır Teşkilat Kimliği.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Hayır Hizmet.
curl --request GET 'https://api.selsup.ru/api/competitor/template' \
  --header 'Authorization: YOUR_API_TOKEN'

Başarılı tepki

200
"string"
Hatalar3

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required
Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied
Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown
Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

GET

Toplama için Get

/api/competitor/collection
Okuma erişimi olan işaret

GET /api/competitor/collection. kullanarak Toplama için Get

curl --request GET 'https://api.selsup.ru/api/competitor/collection' \
  --header 'Authorization: YOUR_API_TOKEN'

Başarılı tepki

200
Array öğesi yapısı Competitor[]
AlanTürZorunluAçıklama
id integer · int64 Hayır Id.
modelId integer · int64 Hayır Model kimliği.
productId integer · int64 Hayır Ürün Kimliği.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Evet Hizmet.
url string Evet - Urt.
serviceId string Hayır Hizmet Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
latestPrice number · double Hayır En son fiyat.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Hayır Para birimi.
latestPriceDate string · date-time Hayır En son fiyat tarihini.
[
  "string"
]
Hatalar5

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required
Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied
Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown
Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

400error_cant_extract_tariffs
Tarifeler alınamıyor. Destek birimine yazın

Uygulama mantığında sabit error_cant_extract_tariffs kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client
Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

GET

1'yi al.

/api/competitor/
Okuma erişimi olan işaret

GET /api/competitor/. kullanarak tüm 1'i alın

curl --request GET 'https://api.selsup.ru/api/competitor/' \
  --header 'Authorization: YOUR_API_TOKEN'

Başarılı tepki

200
Array öğesi yapısı Competitor[]
AlanTürZorunluAçıklama
id integer · int64 Hayır Id.
modelId integer · int64 Hayır Model kimliği.
productId integer · int64 Hayır Ürün Kimliği.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Evet Hizmet.
url string Evet - Urt.
serviceId string Hayır Hizmet Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
latestPrice number · double Hayır En son fiyat.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Hayır Para birimi.
latestPriceDate string · date-time Hayır En son fiyat tarihini.
[
  "string"
]
Hatalar3

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required
Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied
Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown
Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

Authorization

Test istekleri için işaret

Token alın

Token bu tarayıcı lokalStorage'da kalır ve sadece api.selsup.ru adresine Authorization başlığındaki isteklerde gönderilir.

Dene

Gerçek talep parametreleri

Canlı API tepkisi

SelSup cevabını görmek için bir istek gönderin.