პროდუქციის API

დააკავშირეთ თქვენი მაღაზია biznesebi.ge-სთან. ორი გზა არსებობს - აირჩიეთ რომელიც უფრო გიხდებათ.

1. ფიდი (რეკომენდებული)

მოგვცემთ კატალოგის ბმულს, ჩვენ თვითონ ვკითხულობთ დღეში ერთხელ. კოდის დაწერა არ სჭირდება - WooCommerce, OpenCart, Shopify და Magento ასეთ ფაილს უკვე აგენერირებენ.

2. REST API

თუ გყავთ დეველოპერი და გინდათ პროდუქცია მაშინვე განახლდეს - გამოიყენეთ API. იგივე ლოგიკა, უბრალოდ თქვენ გვიგზავნით.

ავთენტიფიკაცია

გასაღები იქმნება პანელში. გადმოეცით ერთ-ერთი სათაურით:

საბაზისო მისამართი

https://biznesebi.ge/api/v1

Authorization: Bearer bzn_live_xxxxxxxxxxxx_yyyy
# ან
X-API-Key: bzn_live_xxxxxxxxxxxx_yyyy

იდემპოტენტურობა

external_id თქვენი პროდუქტის საკუთარი იდენტიფიკატორია. ერთი და იგივე external_id-ით განმეორებით გაგზავნა ერთსა და იმავე ჩანაწერს განაახლებს, დუბლიკატს არ შექმნის. ამიტომ timeout-ის შემდეგ თავიდან გაგზავნა უსაფრთხოა.

მეთოდები

GET/meანგარიშის და ლიმიტების მდგომარეობა

GET/categoriesკატეგორიების სია (?q= ძებნით)

GET/citiesქალაქების სია

GET/productsთქვენი პროდუქცია (cursor-პაგინაცია)

POST/productsპროდუქციის დამატება/განახლება (batch)

GET/products/{external_id}ერთი პროდუქტი

PATCH/products/{external_id}ფასი / მარაგი

DELETE/products/{external_id}არქივში გადატანა

POST /products

curl -X POST https://biznesebi.ge/api/v1/products \
  -H "Authorization: Bearer bzn_live_xxxxxxxxxxxx_yyyy" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [
      {
        "external_id": "SKU-1043",
        "title": "ოფისის სავარძელი Ergo Pro",
        "description": "ერგონომიული სავარძელი წელის საყრდენით.",
        "price": 749.00,
        "currency": "GEL",
        "availability": "IN_STOCK",
        "sku": "ERG-PRO-BLK",
        "brand": "Ergo",
        "product_url": "https://shop.ge/p/1043",
        "images": ["https://shop.ge/img/1043.jpg"],
        "specifications": [
          { "key": "მასალა", "value": "ბადე + ალუმინი" },
          { "key": "წონის ლიმიტი", "value": "130 კგ" }
        ]
      }
    ]
  }'

200 / 201 / 207

{
  "summary": { "created": 1, "updated": 0, "unchanged": 0, "skipped": 0, "failed": 0 },
  "quota": { "limit": 1000, "used": 431, "remaining": 569 },
  "results": [
    { "external_id": "SKU-1043", "status": "created", "id": "cm4x9..." }
  ]
}

PATCH /products/{external_id}

curl -X PATCH https://biznesebi.ge/api/v1/products/SKU-1043 \
  -H "Authorization: Bearer bzn_live_xxxxxxxxxxxx_yyyy" \
  -H "Content-Type: application/json" \
  -d '{ "price": 699.00, "availability": "IN_STOCK" }'

პროდუქტის ველები

ველი	ტიპი	აღწერა
`external_id`სავალდებულო	`string`	თქვენი საკუთარი ID - იდემპოტენტურობის გასაღები
`title`სავალდებულო	`string`	2-200 სიმბოლო
`description`	`string`	მაქს. 5000; თუ არ მიუთითებთ, გამოიყენება title
`type`	`PRODUCT \| SERVICE`	ნაგულისხმევი PRODUCT
`price`	`number \| null`	0 ან null = შეთანხმებით
`price_max`	`number \| null`	თუ price-ზე მეტია, გამოჩნდება დიაპაზონი
`currency`	`GEL \| USD \| EUR`	ნაგულისხმევი GEL
`availability`	`IN_STOCK \| OUT_OF_STOCK \| MADE_TO_ORDER`	მარაგის სტატუსი
`category_id`	`string`	GET /categories-იდან; არასავალდებულო
`city_id`	`string`	GET /cities-იდან; არასავალდებულო
`sku`	`string`	არტიკული / MPN
`brand`	`string`	ავტომატურად ემატება მახასიათებლებში
`min_order_qty`	`integer`	მინიმალური შეკვეთა
`price_unit`	`string`	ცალი, კგ, მ2...
`delivery_info`	`string`	მიწოდების პირობები
`product_url`	`url`	ბმული თქვენს გვერდზე
`images`	`url[]`	მაქს. 20; ჩვენს CDN-ზე გადმოვიტანთ
`specifications`	`{key, value}[]`	მაქს. 50
`publish`	`boolean`	ნაგულისხმევი true

შეცდომები

ყველა შეცდომა ერთნაირი ფორმისაა. კოდზე დაეყრდენით, არა ტექსტზე - ტექსტი შეიძლება შეიცვალოს.

{
  "error": {
    "code": "batch_too_large",
    "message": "This plan allows 100 products per request; 250 were sent."
  },
  "requestId": "0f2c1a64-..."
}

ლიმიტები

ლიმიტი პაკეტზეა დამოკიდებული. მიმდინარე მდგომარეობა ყოველთვის ჩანს GET /api/v1/me-ზე.

მნიშვნელოვანი

ფოტოებს ჩვენს CDN-ზე ვაკოპირებთ - პირდაპირ თქვენს სერვერზე არ ვამისამართებთ. ეს იცავს მომხმარებლების პრივატულობას და ფოტოები არ იკარგება, თუ თქვენს საიტზე მისამართი შეიცვლება.
DELETE არ შლის - არქივში გადააქვს. ბმული, სტატისტიკა და შეკითხვები რჩება.
პანელში ხელით შექმნილ განცხადებას API ვერ შეცვლის. ეს განზრახ არის ასე.
category_id არასავალდებულოა. თუ არ მიუთითებთ, პროდუქტი თქვენი ბიზნესის კატეგორიაში მოხვდება.

შეკითხვები

დაგვიკავშირდით და დაგეხმარებით ინტეგრაციაში.