Markalar
Satıcıya tanımlı markaları döndürür. Ürün Oluşturma isteğindeki brandId bu listeden seçilir.
Gerekli yetki:
product:read
Endpoint
GET /integration/product/sellers/{sellerId}/brands
Production
https://api.milagron.com/integration/product/sellers/{sellerId}/brands
Stage
Yakında
Yanıt (200)
{
"brands": [
{ "id": 5, "name": "Marka Adı" },
{ "id": 8, "name": "Diğer Marka" }
]
}
Alanlar
| Alan | Tip | Açıklama |
|---|---|---|
id | integer | Marka ID'si. Ürün oluşturmada brandId olarak gönderilir. |
name | string | Marka adı. Vitrinde ürünün markası olarak görünür. |
Yalnızca kendi mağazanıza tanımlı markalar döner ve ürün oluştururken yalnızca bunlar
kullanılabilir. Listede olmayan bir
brandId gönderilirse istek
422 ValidationError ile reddedilir.
Komisyon Tanımı
Her markanın Milagron tarafında tanımlı bir komisyon oranı olmalıdır. Tanımlı değilse ürün oluşturma 422 ile reddedilir; bu durumda Milagron ile iletişime geçin.
Kullanım Örnekleri
curl -u "API_KEY:API_SECRET" \
-X GET "https://api.milagron.com/integration/product/sellers/123/brands"<?php
$ch = curl_init('https://api.milagron.com/integration/product/sellers/123/brands');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_USERPWD => 'API_KEY:API_SECRET',
CURLOPT_CUSTOMREQUEST => 'GET',
]);
$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);const auth = Buffer.from('API_KEY:API_SECRET').toString('base64');
const res = await fetch('https://api.milagron.com/integration/product/sellers/123/brands', {
method: 'GET',
headers: {
'Authorization': `Basic ${auth}`
}
});
const data = await res.json();import requests
response = requests.get(
'https://api.milagron.com/integration/product/sellers/123/brands',
auth=('API_KEY', 'API_SECRET')
)
response.raise_for_status()
data = response.json()package main
import (
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.milagron.com/integration/product/sellers/123/brands", nil)
req.SetBasicAuth("API_KEY", "API_SECRET")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
}import java.net.URI;
import java.net.http.*;
import java.util.Base64;
HttpClient client = HttpClient.newHttpClient();
String auth = Base64.getEncoder()
.encodeToString("API_KEY:API_SECRET".getBytes());
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.milagron.com/integration/product/sellers/123/brands"))
.header("Authorization", "Basic " + auth)
.GET()
.build();
HttpResponse<String> response = client.send(request,
HttpResponse.BodyHandlers.ofString());require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.milagron.com/integration/product/sellers/123/brands')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri.request_uri)
request.basic_auth('API_KEY', 'API_SECRET')
response = http.request(request)
data = JSON.parse(response.body)using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
var client = new HttpClient();
var auth = Convert.ToBase64String(
Encoding.UTF8.GetBytes("API_KEY:API_SECRET"));
client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Basic", auth);
var response = await client.GetAsync("https://api.milagron.com/integration/product/sellers/123/brands");
var data = await response.Content.ReadAsStringAsync();Hata Yanıtları
| HTTP | Kod | Durum |
|---|---|---|
| 401 / 403 | Unauthorized / Forbidden | Kimlik doğrulama, yetki (scope) veya satıcı eşleşme hatası. |
| 404 | NotFound | Satıcı bulunamadı. |
| 429 | TooManyRequests | Rate limit. |
Notlar
- Bu endpoint salt-okunurdur; stage ortamında da gerçek veri döner.
- Marka listesi nadiren değişir; istemci tarafında makul süreyle (ör. 1 saat) önbelleklenebilir.
- Yeni marka tanımı Milagron panelinden yapılır; API üzerinden marka oluşturulamaz.