Trendyol API Entegrasyonu Nasıl Yapılır?

Trendyol, Türkiye'nin en büyük e-ticaret platformlarından biri olarak satıcılarına ve iş ortaklarına çeşitli API (Application Programming Interface) seçenekleri sunuyor. Bu API'ler sayesinde stok, sipariş, ürün yönetimi gibi işlemleri otomatikleştirebilir, sistemlerinizle Trendyol arasında kesintisiz veri akışı sağlayabilirsiniz.

1. Trendyol API Nedir?

Trendyol API, satıcıların Trendyol üzerindeki işlemlerini yazılımsal olarak yapabilmelerine olanak tanıyan bir ara yüzdür. Restful mimaride tasarlanmıştır ve genellikle JSON formatında veri alışverişi yapar.

Temel API kullanım alanları:

Ürün yönetimi: Ürünleri listeleme, güncelleme, silme
Stok yönetimi: Depo bilgilerinin senkronizasyonu
Sipariş yönetimi: Yeni siparişlerin çekilmesi, sipariş bilgisi güncellemeleri
Fatura yönetimi: Fatura bilgisi sorgulama

2. Trendyol API Entegrasyon Adımları

2.1. Trendyol Satıcı Hesabı ve API Başvurusu

Trendyol’da kayıtlı aktif bir satıcı olmanız gerekir.
Satıcı panelinde API erişimi için başvuru yapmalısınız.
Başvurunuz onaylandığında, size API anahtarı (API Key), gizli anahtar (Secret Key) ve mağaza kimliği verilir.

2.2. Gerekli Teknolojiler ve Ortam Kurulumu

Programlama dili: PHP, Python, JavaScript (Node.js), Java gibi REST API çağrısı yapabilen diller
İnternet bağlantısı: API’ye HTTPS üzerinden bağlanılır
JSON işleyici: API cevapları JSON formatındadır
İsterseniz hazır SDK ve kütüphaneler (third party) de kullanabilirsiniz ancak resmi dokümantasyon önemlidir.

2.3. API Dokümantasyonunu İnceleyin

Resmi Trendyol API belgeleri:
https://api.trendyol.com/swagger-ui.html (örnek)

Burada:

API endpointleri
Yetkilendirme yöntemleri
Get, Post, Put, Delete istekleri ve beklenen parametreler anlatılır.

2.4. Yetkilendirme (Authentication)

API çağrıları Basic Authentication veya OAuth ile yapılır.
Genel olarak, API key ve secret key kullanılarak HMAC SHA256 imzası oluşturulur.
Bu imza her isteğin header’ına eklenir.

2.5. Örnek Basit Sipariş Listeleme (Python)

import requests
import hmac
import hashlib
import base64
import time

API_KEY = 'your_api_key'
API_SECRET = 'your_api_secret'
API_URL = 'https://api.trendyol.com/sapigw/suppliers/orders'

def generate_signature(api_key, api_secret, timestamp):
    message = api_key + str(timestamp)
    signature = hmac.new(api_secret.encode(), message.encode(), hashlib.sha256).digest()
    return base64.b64encode(signature).decode()

timestamp = int(time.time() * 1000)
signature = generate_signature(API_KEY, API_SECRET, timestamp)

headers = {
    'Authorization': f'{API_KEY}:{signature}',
    'Timestamp': str(timestamp),
    'Content-Type': 'application/json'
}

response = requests.get(API_URL, headers=headers)

print(response.json())

3. Entegrasyon Sürecinde Dikkat Edilmesi Gerekenler

Rate limit (kullanım limiti): API çağrılarınızın aşırı olmamasına dikkat edin, aksi halde bloklanabilirsiniz.
Test ortamı: Entegrasyon yapmadan önce mümkünse sandbox (test) ortamını kullanın.
Hata yönetimi: API dönen hataları doğru analiz edin, örn: 401 Unauthorized, 429 Too Many Requests.
Güvenlik: API anahtarlarınızı güvenli saklayın, kimseyle paylaşmayın.
Veri senkronizasyonu: Stok ve sipariş verilerinizin tutarlı olmasına dikkat edin.

4. Özet

Trendyol API entegrasyonu şu şekilde özetlenebilir:

Satıcı hesabı oluştur ve API erişimi için başvuru yap
API anahtarı aldığında resmi dokümantasyonu detaylı incele
Geli

Trendyol API entegrasyonu nasıl yapılır?