SelSup Developers

Halk API · API İpucu

Üreticiler

İsteğe bağlılık alanı:

5 Son noktaları/api/manufacturerDayanıklıMakine okuyabilir açıklama ↗
{ }

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

/api/manufacturer

Kullanılabilir iş akışları

Kullanılabilir iş akışları

01

Üreticileri 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.

Manufacturer11 alanlar
manufacturerIdinteger · int32

Üreticinin kimliği.

titlestring

Başlık.

namestring

Adı.

Zorunlu
addressstring

Adres.

organizationIdinteger · int64

Teşkilat Kimliği.

clientIdinteger · int64

Müşteri kimliği.

read-only
countryIdinteger · int32

Ülke kimliği.

countryNamestring

Ülke adı.

read-only
innstring

- Ev.

deletedboolean

- Sildi.

oneCIdstring

Bir kişi.

FindResponseManufacturer1 alanlar
rowsManufacturer[]

- Sırada.

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ı

GET

Üreticinin Kimliği

/api/manufacturer/{manufacturerId}
Okuma erişimi olan işaret

GET /api/manufacturer/{manufacturerId}. kullanarak üretici kimliği ile elde edin

Yol parametreleri

AlanTürZorunluAçıklama
manufacturerId integer · int32 Evet Üreticinin kimliği.
curl --request GET 'https://api.selsup.ru/api/manufacturer/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Başarılı tepki

200
Nesne alanları Manufacturer
AlanTürZorunluAçıklama
manufacturerId integer · int32 Hayır Üreticinin kimliği.
title string Hayır Başlık.
name string Evet Adı.
address string Hayır Adres.
organizationId integer · int64 Hayır Teşkilat Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
countryId integer · int32 Hayır Ülke kimliği.
countryName string Hayır Ülke adı.
inn string Hayır - Ev.
deleted boolean Hayır - Sildi.
oneCId string Hayır Bir kişi.
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}
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_manufacturer_not_found
Üretici bulunamadı: {id}

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

400error_subscription_expired
Tarife süreniz doldu. Hizmeti kullanmaya devam etmek için tarifeyi ödeyin.

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

PUT

Güncelleme Üreticisi

/api/manufacturer/{manufacturerId}
Yazma erişimli işaretleme

PUT /api/manufacturer/{manufacturerId}. kullanan üreticinin güncelleştirilmesi

Yol parametreleri

AlanTürZorunluAçıklama
manufacturerId integer · int64 Evet Üreticinin kimliği.

İstekçi organ

application/json
Nesne alanlarıManufacturer
AlanTürZorunluAçıklama
manufacturerId integer · int32 Hayır Üreticinin kimliği.
title string Hayır Başlık.
name string Evet Adı.
address string Hayır Adres.
organizationId integer · int64 Hayır Teşkilat Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
countryId integer · int32 Hayır Ülke kimliği.
countryName string Hayır Ülke adı.
inn string Hayır - Ev.
deleted boolean Hayır - Sildi.
oneCId string Hayır Bir kişi.
curl --request PUT 'https://api.selsup.ru/api/manufacturer/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}'

Başarılı tepki

200
Nesne alanları Manufacturer
AlanTürZorunluAçıklama
manufacturerId integer · int32 Hayır Üreticinin kimliği.
title string Hayır Başlık.
name string Evet Adı.
address string Hayır Adres.
organizationId integer · int64 Hayır Teşkilat Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
countryId integer · int32 Hayır Ülke kimliği.
countryName string Hayır Ülke adı.
inn string Hayır - Ev.
deleted boolean Hayır - Sildi.
oneCId string Hayır Bir kişi.
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "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_empty_manufacturer_name
Üretici adı belirtilmemiş

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

400error_manufacturer_already_exist
{name} adında bir üretici zaten mevcut

Uygulama mantığında sabit error_manufacturer_already_exist 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_subscription_expired
Tarife süreniz doldu. Hizmeti kullanmaya devam etmek için tarifeyi ödeyin.

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

DELETE

Çıkarma Yapımcısı

/api/manufacturer/{manufacturerId}
Yazma erişimli işaretleme

DELETE /api/manufacturer/{manufacturerId}. kullanan üretici

Yol parametreleri

AlanTürZorunluAçıklama
manufacturerId integer · int32 Evet Üreticinin kimliği.

Sorgulama parametreleri

AlanTürZorunluAçıklama
deleted boolean Evet - Sildi.
curl --request DELETE 'https://api.selsup.ru/api/manufacturer/1001?deleted=false' \
  --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.

POST

Yapımcı oluştur

/api/manufacturer
Yazma erişimli işaretleme

POST /api/manufacturer. kullanarak üreticisi oluştur

İstekçi organ

application/json
Nesne alanlarıManufacturer
AlanTürZorunluAçıklama
manufacturerId integer · int32 Hayır Üreticinin kimliği.
title string Hayır Başlık.
name string Evet Adı.
address string Hayır Adres.
organizationId integer · int64 Hayır Teşkilat Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
countryId integer · int32 Hayır Ülke kimliği.
countryName string Hayır Ülke adı.
inn string Hayır - Ev.
deleted boolean Hayır - Sildi.
oneCId string Hayır Bir kişi.
curl --request POST 'https://api.selsup.ru/api/manufacturer' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}'

Başarılı tepki

200
Nesne alanları Manufacturer
AlanTürZorunluAçıklama
manufacturerId integer · int32 Hayır Üreticinin kimliği.
title string Hayır Başlık.
name string Evet Adı.
address string Hayır Adres.
organizationId integer · int64 Hayır Teşkilat Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
countryId integer · int32 Hayır Ülke kimliği.
countryName string Hayır Ülke adı.
inn string Hayır - Ev.
deleted boolean Hayır - Sildi.
oneCId string Hayır Bir kişi.
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "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_empty_manufacturer_name
Üretici adı belirtilmemiş

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

400error_manufacturer_already_exist
{name} adında bir üretici zaten mevcut

Uygulama mantığında sabit error_manufacturer_already_exist 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_subscription_expired
Tarife süreniz doldu. Hizmeti kullanmaya devam etmek için tarifeyi ödeyin.

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

GET

Bul

/api/manufacturer/find
Okuma erişimi olan işaret

GET /api/manufacturer/find. kullanarak bulun

Sorgulama parametreleri

AlanTürZorunluAçıklama
query string Hayır - Merak ediyorum.
manufacturerOneCId string Hayır Üreticiden 1 İKD.
limit integer · int32 Hayır Sınır.
page integer · int32 Hayır Sayfa.
count boolean Hayır Sayın Sayın.
sortBy stringMANUFACTURERID, NAME Hayır - Yürü.
ascending boolean Hayır Yukarı çıkıyorum.
curl --request GET 'https://api.selsup.ru/api/manufacturer/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Başarılı tepki

200
Nesne alanları FindResponseManufacturer
AlanTürZorunluAçıklama
rows Manufacturer[] Hayır - Sırada.
Array öğesi yapısı Manufacturer
AlanTürZorunluAçıklama
manufacturerId integer · int32 Hayır Üreticinin kimliği.
title string Hayır Başlık.
name string Evet Adı.
address string Hayır Adres.
organizationId integer · int64 Hayır Teşkilat Kimliği.
clientId integer · int64 Hayır Müşteri kimliği.
countryId integer · int32 Hayır Ülke kimliği.
countryName string Hayır Ülke adı.
inn string Hayır - Ev.
deleted boolean Hayır - Sildi.
oneCId string Hayır Bir kişi.
{
  "rows": "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_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_subscription_expired
Tarife süreniz doldu. Hizmeti kullanmaya devam etmek için tarifeyi ödeyin.

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