Skip to main content
ePartners

API Documentation

ePartners API უზრუნველყოფს პროგრამულ წვდომას agrosphere.ge-ზე განთავსებული პროდუქტის დეტალებზე. ეს დოკუმენტაცია დაგეხმარებათ გაიგოთ, თუ როგორ გააგზავნოთ მოთხოვნები და მიიღოთ ინფორმაცია ჩვენი სისტემიდან. API შექმნილია იმისთვის, რომ იყოს მარტივი და ინტუიციური, რაც საშუალებას მოგცემთ ეფექტურად მოიპოვოთ საჭირო მონაცემები.

Authorisation

სისტემა იყენებს API Key-ს აუთენტიფიკაციისთვის. თქვენ უნდა მიუთითოთ თქვენი უნიკალური API გასაღები apiKey HTTP ჰედერში ყოველი მოთხოვნისას. გასაღების გარეშე ან არასწორი გასაღების შემთხვევაში, სერვერი დაგიბრუნებთ 401 Unauthorized შეცდომას.

{
    "error": "Unauthenticated."
} 

შენიშვნა: ჩაანაცვლეთ YOUR_API_KEY თქვენი რეალური API გასაღებით. შეავსეთ განაცხადი გასაღების მისაღებად.

Endpoint Details

პროდუქტის ინფორმაციის მისაღებად გამოიყენეთ შემდეგი ენდფოინტი:

URL: https://agrosphere.ge/api/ecommerce-partners

მეთოდი: POST

Request Headers

 სათაური აღწერა მაგალითი
 apiKey თქვენი უნიკალური API გასაღები აუთენტიფიკაციისთვის. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Request Sample (cURL)

ქვემოთ მოცემულია მაგალითი, თუ როგორ უნდა გააკეთოთ მოთხოვნა cURL-ის გამოყენებით:

 curl -X POST \
   'https://agrosphere.ge/api/ecommerce-partners' \
   -H 'apiKey: YOUR_API_KEY'

შენიშვნა: ჩაანაცვლეთ YOUR_API_KEY თქვენი რეალური API გასაღებით.

Successful Response Example

HTTP სტატუსი: 200 OK

{
  "title": "100 ლიტრი - ღვინის უჟანგავი ფოლადის ავზი ბრტყელი ძირით",
  "custom_title": "B0100SAL-F",
  "description": "<h2>100 ლიტრი - ღვინის უჟანგავი ფოლადის ავზი ბრტყელი ძირით&nbsp;</h2><p>უჟანგავი ფოლადის ავზი ბრტყელი ძირით , პოლირებული ზედაპირით და მცურავი ქუდით&nbsp; დამზადებულია AISI 304 მასალისაგან, კედლის სისქე გახლავთ 0.6 მმ. მოცემული ტიპის ავზებში შესაძლებელია სახურავის, ღვინის შესაბამის დონემდე დაშვება.</p><ul><li>წონა 6.8 კგ</li><li>დიამეტრი 470 მმ</li><li>სიმაღლე 580 მმ</li><li>მოცულობა 100 ლ</li><li>მასალა უჟანგავი ფოლადი (AISI 304)</li></ul><p>მთლიანი კომპლექტის შესაძენად, ეწვიეთ ლინკს&nbsp;<strong><a title="\"ღვინის" უჟანგავი ფოლადის ავზი კომპლექტით \" href="\"https://a"grosphere.ge/ge/products/ghvinis-satsarmoo-inventari/ghvinis-tsarmoeba/uzhangavi-litonis-avzi/100-litri-ghvinis-uzhangavi-foladis-avzi-brtqeli-dzirit-komplekti\" target="\"_blank\"" rel="\"noopener\"">ღვინის უჟანგავი ფოლადის ავზი კომპლექტით</a></strong></p>",
  "unique_id": "00-00020804",
  "npm": "00-00020804",
  "stocks": {
    "ონლაინ მაღაზიის საწყობი": 0,
    "თბილისის მაღაზია": 0,
    "თბილისის მაღაზიის საწყობი": 0,
    "ცენტრალური საწყობი #1": 33,
    "ცენტრალური საწყობი #2": 0,
    "ცენტრალური საწყობი #3": 0
  },
  "totalQuantity": 33,
  "images": [
    "https://agrosphere.ge/storage/7844/conversions/BOTTE-SALDATA-FIORETTATA-100-LT-BOTTE-SALDATA-FIORETTATA-100-LT-310x400.jpg"
  ],
  "specifications": {
    "მწარმოებელი": "La Nuova Sansone S.R.L.",
    "ქვეყანა": "იტალია"
  },
  "brand": "",
  "categories": [
    "ღვინის საწარმოო ინვენტარი",
    "ღვინის წარმოება",
    "უჟანგავი ლითონის ავზი"
  ],
  "prices": {
    "retail": "330.00",
    "wholesale": "290.00",
    "discounted": "310.00"
  }
}

Response Fields

ქვემოთ მოცემულია ძირითადი ველების აღწერა, რომლებიც შეიძლება დაბრუნდეს JSON პასუხში:

 ველიტიპიაღწერა
 title String პროდუქტის დასახელება.
 custom_title String პროდუქტის მორგებული სათაური ან კოდი.
 description String პროდუქტის დეტალური აღწერა (შეიძლება შეიცავდეს HTML-ს).
 unique_id String პროდუქტის უნიკალური იდენტიფიკატორი.
 npm String მთავარი პროდუქტის უნიკალური კოდი (გამოიყენება პროდქუტების დასაჯგუფებლად)
 stocks Object ობიექტი, რომელიც შეიცავს ინფორმაციას პროდუქტის მარაგების შესახებ სხვადასხვა ლოკაციაზე.
 totalQuantity Integer პროდუქტის ჯამური რაოდენობა ყველა მარაგში.
 images Array of Strings სურათების URL-ების სია.
 specifications Object პროდუქტის სპეციფიკაციები, როგორიცაა მწარმოებელი, ქვეყანა და ა.შ.
 brand String პროდუქტის ბრენდის დასახელება.
 categories Array of Strings კატეგორიების სია, რომელსაც პროდუქტი მიეკუთვნება.
 prices Object ფასების ინფორმაცია, მათ შორის საცალო (retail), საბითუმო (wholesale) და ფასდაკლებული (discounted) ფასები.

Status Codes

API-ს შეუძლია დააბრუნოს შემდეგი HTTP სტატუს კოდები:

     200 OK : მოთხოვნა წარმატებით შესრულდა და მონაცემები დაბრუნდა.

     401 Unauthorized : ავტორიზაცია ვერ მოხერხდა. API გასაღები არასწორია ან არ არის მითითებული.

     500 Internal Server Error : სერვერზე მოხდა შეცდომა.