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

AlanTipAçıklama
idintegerMarka ID'si. Ürün oluşturmada brandId olarak gönderilir.
namestringMarka 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ı

HTTPKodDurum
401 / 403Unauthorized / ForbiddenKimlik doğrulama, yetki (scope) veya satıcı eşleşme hatası.
404NotFoundSatıcı bulunamadı.
429TooManyRequestsRate 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.