Genel Bakış
Go İthalat REST API, pazaryeri siparişlerinizi otomatik olarak Go İthalat sistemine iletmenizi sağlar.
Base URL
https://www.goithalat.com/rest/
Özellikler
Sipariş oluşturma ve sorgulama
Kargo durumu güncelleme
Entegrasyon Bakiye ile ödeme
Çoklu ürün desteği
Timeout: 30 saniye | Format: application/x-www-form-urlencoded (POST) | JSON response
API Limitleri
Parametre Değer
İstek limiti 60 istek / dakika (token başına)
Timeout 30 saniye
Maksimum ürün (sipariş başına) 50 ürün
İstek formatı application/x-www-form-urlencoded
Yanıt formatı JSON
Uyarı: Dakikada 60 istekten fazla gönderilmesi durumunda geçici olarak erişim engellenebilir. İsteklerinizi minimum 1 saniye aralıkla göndermeniz önerilir.
Kimlik Doğrulama
Her istekte Authorization header'i gönderilmelidir. Kimlik dogrulama Bearer Token ile yapılır. Token, Go İthalat admin panelinden otomatik oluşturulur.
Token Kullanımı
Her istekte aşağıdaki header gönderilmelidir:
Authorization: Bearer YOUR_API_TOKEN
Token, Go İthalat admin panelinde Kullanıcı Yönetimi > kullanıcı detayında Token alanında otomatik oluşturulur.Whatsapp Hattımızdan talep etmeniz gereklidir. API anahtarı olarak bu tokenin md5() değerini kullanın.
Python Örneği
Kopyalaimport requests
API_TOKEN = "abc123def456..." # Go Ithalat panelinden alinan md5(token)
BASE_URL = "https://www.goithalat.com/rest"
headers = {"Authorization": f"Bearer {API_TOKEN}"}
# Sipariş sorgula
resp = requests.get(
f"{BASE_URL}/getOrder",
params={"no": "TY-1234567890"},
headers=headers,
timeout=10
)
print(resp.text)
PHP Örneği
Kopyala$token = "abc123def456..."; // Go Ithalat panelinden alinan md5(token)
$ch = curl_init("https://www.goithalat.com/rest/getOrder?no=TY-123");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer " . $token
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
Guvenlik: Token değerinizi asla istemci tarafında (frontend/JavaScript) olusturmayin. Her zaman sunucu tarafında kullanın.
Sipariş Oluştur
POST
https://www.goithalat.com/rest/setOrder
Parametreler
Parametre Tip Zorunlu Açıklama
nostring Evet Sipariş numarası (örn: TY-123456)
namestring Evet Müşteri adı ve soyadı (örnek: Ahmet Yılmaz)
emailstring Hayir Bearer Token kullanildiginda otomatik doldurulur. Gönderilmezse token sahibinin e-maili kullanılır.
ccodestring Hayir Pazaryeri kargo takip kodu (örnek: Trendyol Aras kodu 7260032866724072)
odemeTipistring Evet "Entegrasyon Bakiye"
kargoFirmaIDinteger Evet Kargo firma ID (bkz. Kargo Kodları)
urunID_1integer Evet Go İthalat ürün ID (1. ürün)
urunAdet_1integer Evet 1. ürün adedi
urunID_2integer Hayir 2. ürün ID (çoklu ürün için)
urunAdet_2integer Hayir 2. ürün adedi
Python Örneği
Kopyalaimport requests
payload = {
"no": "TY-1234567890",
"name": "Ahmet Yilmaz",
"email": "bayi@firma.com",
"ccode": "KARGO_TAKIP_NO",
"odemeTipi": "Entegrasyon Bakiye",
"kargoFirmaID": 5,
"urunID_1": 44218,
"urunAdet_1": 2,
"urunID_2": 44350,
"urunAdet_2": 1
}
headers = {"Authorization": "Bearer abc123def456..."}
resp = requests.post("https://www.goithalat.com/rest/setOrder",
data=payload, headers=headers, timeout=30)
print(resp.text)
PHP Örneği
Kopyala$payload = [
"no" => "TY-1234567890",
"name" => "Ahmet Yilmaz",
"email" => "bayi@firma.com",
"odemeTipi" => "Entegrasyon Bakiye",
"kargoFirmaID" => 5,
"urunID_1" => 44218,
"urunAdet_1" => 2
];
$ch = curl_init("https://www.goithalat.com/rest/setOrder");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer abc123def456..."]);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
Başarılı Yanıt
{ "Success": true, "SIPARIS_NO": "TY-1234567890" }
Sipariş Sorgula
GET
https://www.goithalat.com/rest/getOrder?no={siparis_no}
Parametreler (Query String)
Parametre Tip Zorunlu Açıklama
nostring Evet Sipariş numarası
Yanıt Ornegi
{
"ID": 12345,
"no": "TY-1234567890",
"name": "Ahmet Yilmaz",
"status": 10
}
Sipariş bulunamazsa boş yanıt veya ID: 0 doner. Mükerrer sipariş kontrolü için bu endpoint'i kullanın.
Sipariş Durumu Güncelle
POST
https://www.goithalat.com/rest/setOrderStatus
Parametreler
Parametre Tip Zorunlu Açıklama
nostring Evet Sipariş numarası
statusinteger Evet Hedef durum kodu (2, 51, 90)
kargoTarihstring status=51 ise Kargo tarihi (YYYY-MM-DD)
kargoFirmainteger status=51 ise Kargo firma ID
kargoSeriNostring Hayir Kargo takip numarası
Durum Kodları
2 — Sipariş Onaylandı / Hazırlanıyor
51 — Kargoya Teslim Edildi
90 — İptal Talebi Alındı
Kargo Firma Kodları
Siparis olustururken kargoFirmaID degerini asagidaki tablodan secin.
Trendyol
Kargo Firması ID
Aras Kargo 5
Surat Kargo 60
Hepsiburada
Kargo Firması ID
Aras Kargo 6
Surat Kargo 84
Pazarama
Kargo Firması ID
Surat Kargo 87
Aras Kargo 96
N11
Kargo Firması ID
Aras Kargo 4
Surat Kargo 85
Ciceksepeti
Kargo Firması ID
Aras Kargo 37
Sürat Kargo 67
Varsayılan kargo firma ID: 87 (Surat Kargo). Eğer kargo firması belirlenemezse bu değer kullanılır.
Hata Kodları ve Yanıtlar
Yanıt Anlamı Çözüm
Bakiye YetersizHesapta yeterli bakiye yok Entegrasyon bakiyenizi yükleyin
SuccessSipariş başarıyla oluşturuldu -
ID: 0Sipariş bulunamadı (getOrder) Sipariş numarasını kontrol edin
Boş yanıt Geçersiz veya eksik Bearer Token Bearer Token değerini kontrol edin
Sipariş Numarası Formatı
Mükerrer engeli için sipariş numarasının başına platform prefix'i eklemeniz önerilir:
Platform Prefix Örnek
Trendyol TY-TY-1234567890
Hepsiburada HB-HB-4588232632
Pazarama PZ-PZ-9876543210
Ciceksepeti CS-CS-5555666677
N11 N11-N11-1112223334
Idefix IX-IX-IDE6a043cc4769f0