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.

4 Son noktaları/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.

Competitor6 alanlar
idinteger · int64

Id.

read-only
modelIdinteger · int64

Model kimliği.

servicestring

Hizmet.

Zorunlu
urlstring

- Urt.

Zorunlu
serviceIdstring

Hizmet Kimliği.

clientIdinteger · int64

Müşteri kimliği.

read-only

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.
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 Evet Hizmet.
url string Evet - Urt.
serviceId string Hayır Hizmet Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
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,
  "serviceId": "string",
  "clientId": 1001
}'

Başarılı tepki

200

Cevapın bir vücudu yok.

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_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_required
Rakip zorunludur

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

400error_competitor_service_required
Rakip servisi zorunludur

Uygulama mantığında sabit error_competitor_service_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.

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.

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_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_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.
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 Evet Hizmet.
url string Evet - Urt.
serviceId string Hayır Hizmet Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
[
  "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_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.
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 Evet Hizmet.
url string Evet - Urt.
serviceId string Hayır Hizmet Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
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,
  "serviceId": "string",
  "clientId": 1001
}'

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.
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 Evet Hizmet.
url string Evet - Urt.
serviceId string Hayır Hizmet Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "serviceId": "string",
  "clientId": 1001
}
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_competitor_required
Rakip zorunludur

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

400error_competitor_service_required
Rakip servisi zorunludur

Uygulama mantığında sabit error_competitor_service_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.

Authorization

Test istekleri için işaret

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.