Mybuy.ge

API მაღაზიებისთვის

Mybuy.ge-ს API-თი შენი მაღაზიის სისტემა (საიტი, საწყობის პროგრამა, 1C, სკრიპტი) თავად ატვირთავს განცხადებებს, განაახლებს ფასსა და მარაგს და წაიკითხავს შეკვეთებს.

1. გასაღები

2. მისამართები

საბაზისო მისამართი: https://mybuy.ge/api/v1. ფორმატი — JSON, UTF-8.

GET/categoriesკატეგორიები, ქვეკატეგორიები, ველები და მნიშვნელობები, ქალაქები, მოდელები (გასაღები არ სჭირდება)
GET/meვისი გასაღებია, განცხადებების რაოდენობა
GET/listings?status=active&page=1&limit=50შენი განცხადებები (status: active | sold | removed | all)
POST/listingsახალი განცხადება; იგივე externalId-ით — განახლება
GET/listings/{id}ერთი განცხადება ({id} ან ext:შენი_კოდი)
PUT/listings/{id}სრული განახლება
PATCH/listings/{id}ფასი / ძველი ფასი / მარაგი / სტატუსი
DELETE/listings/{id}მოხსნა საიტიდან
GET/orders?status=placed&since=2026-10-01T00:00:00Zშენი გაყიდვები (შეკვეთები)

3. განცხადების ატვირთვა

curl -X POST https://mybuy.ge/api/v1/listings \
  -H "Authorization: Bearer mb_live_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "SKU-10045",
    "title": "iPhone 15 Pro 256GB, ახალი",
    "description": "ოფიციალური გარანტია 1 წელი, ყუთში, ყველა აქსესუარით.",
    "category": "electronics",
    "subcategory": "phones",
    "city": "თბილისი",
    "price": 3299,
    "oldPrice": 3599,
    "currency": "GEL",
    "condition": "NEW",
    "extra": { "brand": "Apple", "model": "iPhone 15 Pro", "memory": "256GB" },
    "tags": ["iphone", "apple", "ახალი"],
    "photoUrls": ["https://shop.ge/img/10045-1.jpg", "https://shop.ge/img/10045-2.jpg"],
    "onlineSale": true, "stock": 7, "allowPickup": true, "courierPrice": 5, "shippingPrice": 10
  }'

4. ფასისა და მარაგის სწრაფი განახლება

curl -X PATCH https://mybuy.ge/api/v1/listings/ext:SKU-10045 \
  -H "Authorization: Bearer mb_live_XXXXXXXX" -H "Content-Type: application/json" \
  -d '{ "price": 3199, "stock": 4 }'

ონლაინ-გაყიდვის განცხადება მარაგის 0-ზე ავტომატურად ხდება „გაყიდული“, მარაგის დამატებისას — ისევ აქტიური.

5. შეკვეთების წაკითხვა

curl "https://mybuy.ge/api/v1/orders?since=2026-10-27T00:00:00Z" -H "Authorization: Bearer mb_live_XXXXXXXX"

თითო შეკვეთაში: ნომერი, სტატუსი, შენი externalId, რაოდენობა, თანხა, მიწოდების გზა, მყიდველის სახელი, ტელეფონი და მისამართი.

6. შეცდომები

HTTP 400
{ "error": { "code": "errTitle", "message": "Title needs at least 4 characters", "field": "title" } }