Tedbul API
Tedbul API Dökümantasyonuna Hoşgeldiniz. Postman Collection kullanarak API testleri sağlayabilirsiniz.
Live API : https://api.tedbul.com.tr/
Test API : https://test-api.tedbul.com.tr/
1. Giriş
Kimlik Doğrulaması.
API Erişimi sağlayabilmek için, Tedbul.com.tr üyeliğine ve gizli anahtar bilgisine sahip olmanız gereklidir.
Gizli anahtarınız yoksa [email protected] adresine kullanıcı adınızı ve entegrasyon firmasının bilgisini mail atarak gizli anahtarınızı temin edebilirsiniz.
Tedbul API JWT Auth Token ile çalışmaktadır.
Kullanıcı doğrulaması yaptıktan sonra, response edilen token değeri ile request işlemi yapabilirsiniz.
Token Süresi 3 Saattir.
Example request:
curl -X POST \
"https://api.tedbul.com.tr/api/auth" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"username":"xxx","password":"xxx","secretkey":"xxx"}'
$client = new \GuzzleHttp\Client();
$response = $client->post(
'https://api.tedbul.com.tr/api/auth',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'json' => [
'username' => 'xxx',
'password' => 'xxx',
'secretkey' => 'xxx'
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json
url = 'https://api.tedbul.com.tr/api/auth'
payload = {
"username": "xxx",
"password": "xxx",
"secretkey": "xxx"
}
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('POST', url, headers=headers, json=payload)
response.json()
const url = new URL(
"https://api.tedbul.com.tr/api/auth"
);
let headers = {
"Content-Type": "application/json",
"Accept": "application/json"
};
let body = {
"username": "xxx",
"password": "xxx",
"secretkey": "xxx"
}
fetch(url, {
method: "POST",
headers: headers,
body: body
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"status": true,
"code": 200,
"message": "ok",
"result": {
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC9hcGkudGVkYnVsLmNvbS50clwvYXBpXC9hdXRoIiwiaWF0IjoxNTc5NjI3ODkwLCJleHAiOjE1Nzk2Mzg2OTAsIm5iZiI6MTU3OTYyNzg5MCwianRpIjoicUxOWkkyQ2FudHBnd1dmVCIsInN1YiI6WFgsInBydiI6Ijg3ZTBhZjFlZjlmZDE1ODEyZmRlYzk3MTUzYTE0ZTBiMDQ3NTQ2YWEifQ.3It3LcLD6eUyb9SjFcPUHMZawuYL9kxBJZ9WvlvBvWI",
"tokenType": "bearer",
"expiresDate": "YYYY-MM-DD H:I:S"
}
}
HTTP Request
POST api/auth
Body Parameters
Parameter | Type | Status | Description |
---|---|---|---|
username |
required | optional | Tedbul Kullanıcı Adınız |
password |
required | optional | Tedbul Şifreniz |
secretkey |
required | optional | Tedbul Gizli Anahtarınız |
2. Sattıklarım
Satış Listesi
Example request:
curl -X GET \
-G "https://api.tedbul.com.tr/api/orders/getSoldList?page=1&show=50&startDate=2020-01-01&endDate=2020-01-31&orderStatus=1" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {Token}"
$client = new \GuzzleHttp\Client();
$response = $client->get(
'https://api.tedbul.com.tr/api/orders/getSoldList',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {Token}',
],
'query' => [
'page' => 1,
'show' => 50,
'startDate' => '2020-01-01',
'endDate' => '2020-01-31',
'orderStatus' => 1,
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json
url = 'https://api.tedbul.com.tr/api/orders/getSoldList'
params = {
'page' : 1,
'show' : 50,
'startDate' : '2020-01-01',
'endDate' : '2020-01-31',
'orderStatus' : 1,
}
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {Token}'
}
response = requests.request('GET', url, headers=headers, params=params)
response.json()
const url = new URL(
"https://api.tedbul.com.tr/api/orders/getSoldList"
);
let params = {
'page' : 1,
'show' : 50,
'startDate' : '2020-01-01',
'endDate' : '2020-01-31',
'orderStatus' : 1,
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
let headers = {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {Token}",
};
fetch(url, {
method: "GET",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"status": true,
"code": 200,
"message": "ok",
"result": {
"total": "integer Toplam Sipariş",
"data": [
{
"orderId": "integer Sipariş ID",
"orderCode": "string Sipariş Numarası",
"orderDate": "datetime Sipariş Tarihi",
"orderStatus": "int Sipariş Durum Kodu",
"orderStatusText": "string Sipariş Durum Tanımı",
"orderNote": "string Sipariş Notu",
"cancelNote": "string İptal Nedeni",
"orderPrice": "decimal Sipariş Tutarı",
"orderRefundPrice": "decimal İade Tutarı",
"orderCargoDesi": "integer Kargo Desi",
"orderCargoCompanyId": "integer Kargo Firma ID",
"orderCargoCompanyText": "string Kargo Firma Tanımı",
"buyerId": "integer Alıcı ID",
"buyerUsername": "string Alıcı Kullanıcı Adı",
"sellerId": "integer Satıcı ID",
"sellerUsername": "string Satıcı Kullanıcı Adı",
"shippingCargoCode": "integer Kargo Gönderi Kodu",
"sendFollowCargoCode": "integer Kargo Takip Kodu",
"refundFollowCargoCode": "integer İade Kargosu Takip Kodu",
"cargoRequestDate": "datetime Kargo Gönderisi Oluşturma Tarihi",
"cargoDeliveryDate": "datetime Kargo Teslim Tarihi",
"buyerFullName": "string Alıcı Adı Soyadı",
"buyerInvoiceCompanyName": "string Alıcı Fatura Ünvanı",
"buyerInvoicePhone": "string Alıcı Telefon Numarası",
"buyerInvoiceEmail": "string Alıcı E-Posta Adresi",
"buyerInvoiceTaxOrTcNo": "integer Alıcı T.C Numarası veya Vergi Numarası",
"buyerInvoiceTaxOffice": "string Alıcı Vergi Dairesi",
"buyerInvoiceAddress": "string Alıcı Fatura Adresi",
"buyerInvoiceCity": "string Alıcı Fatura İli",
"buyerInvoiceTown": "string Alıcı Fatura İlçesi",
"buyerDeliveryAddress": "string Alıcı Sevk Adresi",
"buyerDeliveryTown": "string Alıcı Sevk İli",
"buyerDeliveryCity": "string Alıcı Sevk İlçesi",
"orderProducts": [
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
},
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
},
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
}
]
},
{
"orderId": "integer Sipariş ID",
"orderCode": "string Sipariş Numarası",
"orderDate": "datetime Sipariş Tarihi",
"orderStatus": "int Sipariş Durum Kodu",
"orderStatusText": "string Sipariş Durum Tanımı",
"orderNote": "string Sipariş Notu",
"cancelNote": "string İptal Nedeni",
"orderPrice": "decimal Sipariş Tutarı",
"orderRefundPrice": "decimal İade Tutarı",
"orderCargoDesi": "integer Kargo Desi",
"orderCargoCompanyId": "integer Kargo Firma ID",
"orderCargoCompanyText": "string Kargo Firma Tanımı",
"buyerId": "integer Alıcı ID",
"buyerUsername": "string Alıcı Kullanıcı Adı",
"sellerId": "integer Satıcı ID",
"sellerUsername": "string Satıcı Kullanıcı Adı",
"shippingCargoCode": "integer Kargo Gönderi Kodu",
"sendFollowCargoCode": "integer Kargo Takip Kodu",
"refundFollowCargoCode": "integer İade Kargosu Takip Kodu",
"cargoRequestDate": "datetime Kargo Gönderisi Oluşturma Tarihi",
"cargoDeliveryDate": "datetime Kargo Teslim Tarihi",
"buyerFullName": "string Alıcı Adı Soyadı",
"buyerInvoiceCompanyName": "string Alıcı Fatura Ünvanı",
"buyerInvoicePhone": "string Alıcı Telefon Numarası",
"buyerInvoiceEmail": "string Alıcı E-Posta Adresi",
"buyerInvoiceTaxOrTcNo": "integer Alıcı T.C Numarası veya Vergi Numarası",
"buyerInvoiceTaxOffice": "string Alıcı Vergi Dairesi",
"buyerInvoiceAddress": "string Alıcı Fatura Adresi",
"buyerInvoiceCity": "string Alıcı Fatura İli",
"buyerInvoiceTown": "string Alıcı Fatura İlçesi",
"buyerDeliveryAddress": "string Alıcı Sevk Adresi",
"buyerDeliveryTown": "string Alıcı Sevk İli",
"buyerDeliveryCity": "string Alıcı Sevk İlçesi",
"orderProducts": [
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
},
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
},
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
}
]
}
]
}
}
HTTP Request
GET api/orders/getSoldList
orderStatus
alabildiği değerler;
BOŞ | Tüm Siparişler
0 | Satıcı Onayı Bekliyor
1 | Kargolanması Bekleniyor
2 | Kargoda
3 | Tamamlandı
4 | İptal Edildi
6 | Alıcı Onayı Bekleniyor
8 | İptal Talebi
Query Parameters
Parameter | Status | Description | |
---|---|---|---|
page |
optional | int optional Sayfa | Varsayılan: 1 |
show |
optional | int optional Sayfa başına gösterilecek satır | Varsayılan: 50 |
startDate |
optional | date YYYY-MM-DD Başlangıç Tarihi | Varsayılan: Mevcut Tarihin 1 Ay öncesi |
endDate |
optional | date YYYY-MM-DD Bitiş Tarihi | Varsayılan: Mevcut Tarih |
orderStatus |
optional | int optional Sipariş Durumu |
Satış Detayı
Example request:
curl -X GET \
-G "https://api.tedbul.com.tr/api/orders/getSold/1" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {Token}"
$client = new \GuzzleHttp\Client();
$response = $client->get(
'https://api.tedbul.com.tr/api/orders/getSold/1',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {Token}',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json
url = 'https://api.tedbul.com.tr/api/orders/getSold/1'
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {Token}'
}
response = requests.request('GET', url, headers=headers)
response.json()
const url = new URL(
"https://api.tedbul.com.tr/api/orders/getSold/1"
);
let headers = {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {Token}",
};
fetch(url, {
method: "GET",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"status": true,
"code": 200,
"message": "ok",
"result": {
"data": {
"orderId": "integer Sipariş ID",
"orderCode": "string Sipariş Numarası",
"orderDate": "datetime Sipariş Tarihi",
"orderStatus": "int Sipariş Durum Kodu",
"orderStatusText": "string Sipariş Durum Tanımı",
"orderNote": "string Sipariş Notu",
"cancelNote": "string İptal Nedeni",
"orderPrice": "decimal Sipariş Tutarı",
"orderRefundPrice": "decimal İade Tutarı",
"orderCargoDesi": "integer Kargo Desi",
"orderCargoCompanyId": "integer Kargo Firma ID",
"orderCargoCompanyText": "string Kargo Firma Tanımı",
"buyerId": "integer Alıcı ID",
"buyerUsername": "string Alıcı Kullanıcı Adı",
"sellerId": "integer Satıcı ID",
"sellerUsername": "string Satıcı Kullanıcı Adı",
"shippingCargoCode": "integer Kargo Gönderi Kodu",
"sendFollowCargoCode": "integer Kargo Takip Kodu",
"refundFollowCargoCode": "integer İade Kargosu Takip Kodu",
"cargoRequestDate": "datetime Kargo Gönderisi Oluşturma Tarihi",
"cargoDeliveryDate": "datetime Kargo Teslim Tarihi",
"buyerFullName": "string Alıcı Adı Soyadı",
"buyerInvoiceCompanyName": "string Alıcı Fatura Ünvanı",
"buyerInvoicePhone": "string Alıcı Telefon Numarası",
"buyerInvoiceEmail": "string Alıcı E-Posta Adresi",
"buyerInvoiceTaxOrTcNo": "integer Alıcı T.C Numarası veya Vergi Numarası",
"buyerInvoiceTaxOffice": "string Alıcı Vergi Dairesi",
"buyerInvoiceAddress": "string Alıcı Fatura Adresi",
"buyerInvoiceCity": "string Alıcı Fatura İli",
"buyerInvoiceTown": "string Alıcı Fatura İlçesi",
"buyerDeliveryAddress": "string Alıcı Sevk Adresi",
"buyerDeliveryTown": "string Alıcı Sevk İli",
"buyerDeliveryCity": "string Alıcı Sevk İlçesi",
"orderProducts": [
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
},
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
},
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
}
]
}
}
}
HTTP Request
GET api/orders/getSold/{id}
URL Parameters
Parameter | Status | Description |
---|---|---|
id |
required | int Satış ID |
Sipariş Onaylama
Example request:
curl -X POST \
"https://api.tedbul.com.tr/api/orders/orderConfirmation" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {Token}" \
-d '{"orderId":19,"products":[{"penId":3,"approvedQty":7}]}'
$client = new \GuzzleHttp\Client();
$response = $client->post(
'https://api.tedbul.com.tr/api/orders/orderConfirmation',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {Token}',
],
'json' => [
'orderId' => 19,
'products' => [
[
'penId' => 3,
'approvedQty' => 7,
],
],
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json
url = 'https://api.tedbul.com.tr/api/orders/orderConfirmation'
payload = {
"orderId": 19,
"products": [
{
"penId": 3,
"approvedQty": 7
}
]
}
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {Token}'
}
response = requests.request('POST', url, headers=headers, json=payload)
response.json()
const url = new URL(
"https://api.tedbul.com.tr/api/orders/orderConfirmation"
);
let headers = {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {Token}",
};
let body = {
"orderId": 19,
"products": [
{
"penId": 3,
"approvedQty": 7
}
]
}
fetch(url, {
method: "POST",
headers: headers,
body: body
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"status": true,
"code": 200,
"message": "ok",
"result": {
"data": {
"orderId": "integer Sipariş ID",
"orderCode": "string Sipariş Numarası",
"orderDate": "datetime Sipariş Tarihi",
"orderStatus": "int Sipariş Durum Kodu",
"orderStatusText": "string Sipariş Durum Tanımı",
"orderNote": "string Sipariş Notu",
"cancelNote": "string İptal Nedeni",
"orderPrice": "decimal Sipariş Tutarı",
"orderRefundPrice": "decimal İade Tutarı",
"orderCargoDesi": "integer Kargo Desi",
"orderCargoCompanyId": "integer Kargo Firma ID",
"orderCargoCompanyText": "string Kargo Firma Tanımı",
"buyerId": "integer Alıcı ID",
"buyerUsername": "string Alıcı Kullanıcı Adı",
"sellerId": "integer Satıcı ID",
"sellerUsername": "string Satıcı Kullanıcı Adı",
"shippingCargoCode": "integer Kargo Gönderi Kodu",
"sendFollowCargoCode": "integer Kargo Takip Kodu",
"refundFollowCargoCode": "integer İade Kargosu Takip Kodu",
"cargoRequestDate": "datetime Kargo Gönderisi Oluşturma Tarihi",
"cargoDeliveryDate": "datetime Kargo Teslim Tarihi",
"orderProducts": [
{
"penId": "integer ID",
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
},
{
"penId": "integer ID",
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
},
{
"penId": "integer ID",
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
}
]
}
}
}
HTTP Request
POST api/orders/orderConfirmation
Body Parameters
Parameter | Type | Status | Description |
---|---|---|---|
orderId |
integer | optional | Sipariş ID |
products |
array | required | Ürün Kalemleri |
products[][penId] |
integer | required | Ürün Kalemleri |
products[][approvedQty] |
integer | required | Ürün Kalemleri |
3. Aldıklarım
Alış Listesi
Example request:
curl -X GET \
-G "https://api.tedbul.com.tr/api/orders/getPurchasedList?page=1&show=50&startDate=2020-01-01&endDate=2020-01-31&orderStatus=1" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {Token}"
$client = new \GuzzleHttp\Client();
$response = $client->get(
'https://api.tedbul.com.tr/api/orders/getPurchasedList',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {Token}',
],
'query' => [
'page' => 1,
'show' => 50,
'startDate' => '2020-01-01',
'endDate' => '2020-01-31',
'orderStatus' => 1,
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json
url = 'https://api.tedbul.com.tr/api/orders/getPurchasedList'
params = {
'page' : 1,
'show' : 50,
'startDate' : '2020-01-01',
'endDate' : '2020-01-31',
'orderStatus' : 1,
}
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {Token}'
}
response = requests.request('GET', url, headers=headers, params=params)
response.json()
const url = new URL(
"https://api.tedbul.com.tr/api/orders/getPurchasedList"
);
let params = {
'page' : 1,
'show' : 50,
'startDate' : '2020-01-01',
'endDate' : '2020-01-31',
'orderStatus' : 1,
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
let headers = {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {Token}",
};
fetch(url, {
method: "GET",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"status": true,
"code": 200,
"message": "ok",
"result": {
"total": "integer Toplam Sipariş",
"data": [
{
"orderId": "integer Sipariş ID",
"orderCode": "string Sipariş Numarası",
"orderDate": "datetime Sipariş Tarihi",
"orderStatus": "int Sipariş Durum Kodu",
"orderStatusText": "string Sipariş Durum Tanımı",
"orderNote": "string Sipariş Notu",
"cancelNote": "string İptal Nedeni",
"orderPrice": "decimal Sipariş Tutarı",
"orderRefundPrice": "decimal İade Tutarı",
"orderCargoDesi": "integer Kargo Desi",
"orderCargoCompanyId": "integer Kargo Firma ID",
"orderCargoCompanyText": "string Kargo Firma Tanımı",
"buyerId": "integer Alıcı ID",
"buyerUsername": "string Alıcı Kullanıcı Adı",
"sellerId": "integer Satıcı ID",
"sellerUsername": "string Satıcı Kullanıcı Adı",
"shippingCargoCode": "integer Kargo Gönderi Kodu",
"sendFollowCargoCode": "integer Kargo Takip Kodu",
"refundFollowCargoCode": "integer İade Kargosu Takip Kodu",
"cargoRequestDate": "datetime Kargo Gönderisi Oluşturma Tarihi",
"cargoDeliveryDate": "datetime Kargo Teslim Tarihi",
"orderProducts": [
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
},
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
},
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
}
]
},
{
"orderId": "integer Sipariş ID",
"orderCode": "string Sipariş Numarası",
"orderDate": "datetime Sipariş Tarihi",
"orderStatus": "int Sipariş Durum Kodu",
"orderStatusText": "string Sipariş Durum Tanımı",
"orderNote": "string Sipariş Notu",
"cancelNote": "string İptal Nedeni",
"orderPrice": "decimal Sipariş Tutarı",
"orderRefundPrice": "decimal İade Tutarı",
"orderCargoDesi": "integer Kargo Desi",
"orderCargoCompanyId": "integer Kargo Firma ID",
"orderCargoCompanyText": "string Kargo Firma Tanımı",
"buyerId": "integer Alıcı ID",
"buyerUsername": "string Alıcı Kullanıcı Adı",
"sellerId": "integer Satıcı ID",
"sellerUsername": "string Satıcı Kullanıcı Adı",
"shippingCargoCode": "integer Kargo Gönderi Kodu",
"sendFollowCargoCode": "integer Kargo Takip Kodu",
"refundFollowCargoCode": "integer İade Kargosu Takip Kodu",
"cargoRequestDate": "datetime Kargo Gönderisi Oluşturma Tarihi",
"cargoDeliveryDate": "datetime Kargo Teslim Tarihi",
"orderProducts": [
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
},
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
},
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
}
]
}
]
}
}
HTTP Request
GET api/orders/getPurchasedList
Query Parameters
orderStatus
alabildiği değerler;
BOŞ | Tüm Siparişler
0 | Satıcı Onayı Bekliyor
1 | Kargolanması Bekleniyor
2 | Kargoda
3 | Tamamlandı
4 | İptal Edildi
6 | Alıcı Onayı Bekleniyor
8 | İptal Talebi
Parameter | Status | Description | |
---|---|---|---|
page |
optional | int optional Sayfa | Varsayılan: 1 |
show |
optional | int optional Sayfa başına gösterilecek satır | Varsayılan: 50 |
startDate |
optional | date YYYY-MM-DD Başlangıç Tarihi | Varsayılan: Mevcut Tarihin 1 Ay öncesi |
endDate |
optional | date YYYY-MM-DD Bitiş Tarihi | Varsayılan: Mevcut Tarih |
orderStatus |
optional | int optional Sipariş Durumu |
<!-- END_3e76643f6c52ff79c7a1d6830ce0a559 -->
Alış Detayı
Example request:
curl -X GET \
-G "https://api.tedbul.com.tr/api/orders/getPurchased/1" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {Token}"
$client = new \GuzzleHttp\Client();
$response = $client->get(
'https://api.tedbul.com.tr/api/orders/getPurchased/1',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {Token}',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json
url = 'https://api.tedbul.com.tr/api/orders/getPurchased/1'
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {Token}'
}
response = requests.request('GET', url, headers=headers)
response.json()
const url = new URL(
"https://api.tedbul.com.tr/api/orders/getPurchased/1"
);
let headers = {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {Token}",
};
fetch(url, {
method: "GET",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"status": true,
"code": 200,
"message": "ok",
"result": {
"data": {
"orderId": "integer Sipariş ID",
"orderCode": "string Sipariş Numarası",
"orderDate": "datetime Sipariş Tarihi",
"orderStatus": "int Sipariş Durum Kodu",
"orderStatusText": "string Sipariş Durum Tanımı",
"orderNote": "string Sipariş Notu",
"cancelNote": "string İptal Nedeni",
"orderPrice": "decimal Sipariş Tutarı",
"orderRefundPrice": "decimal İade Tutarı",
"orderCargoDesi": "integer Kargo Desi",
"orderCargoCompanyId": "integer Kargo Firma ID",
"orderCargoCompanyText": "string Kargo Firma Tanımı",
"buyerId": "integer Alıcı ID",
"buyerUsername": "string Alıcı Kullanıcı Adı",
"sellerId": "integer Satıcı ID",
"sellerUsername": "string Satıcı Kullanıcı Adı",
"shippingCargoCode": "integer Kargo Gönderi Kodu",
"sendFollowCargoCode": "integer Kargo Takip Kodu",
"refundFollowCargoCode": "integer İade Kargosu Takip Kodu",
"cargoRequestDate": "datetime Kargo Gönderisi Oluşturma Tarihi",
"cargoDeliveryDate": "datetime Kargo Teslim Tarihi",
"orderProducts": [
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
},
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
},
{
"orderProductId": "integer Ürün ID",
"orderProductName": "string Ürün Adı",
"orderProductBarcode": "string Barkod",
"orderProductVAT": "integer Kdv Oranı",
"orderProductExpiration": "date Ürün Miadı",
"orderQty": "integer Ürün Adeti",
"orderApprovedQty": "integer Onaylanan Satış Adeti",
"orderTotalPrice": "decimal Toplam Ürün Tutarı",
"orderProductPrice": "decimal Birim Fiyatı",
"orderApprovedPrice": "decimal Onaylanan Ürün Toplam Tutarı",
"orderRefundPrice": "decimal İade Tutarı"
}
]
}
}
}
HTTP Request
GET api/orders/getPurchased/{id}
URL Parameters
Parameter | Status | Description |
---|---|---|
id |
required | int Satış ID |
4. İlanlar
Yeni İlan Ekle
productBarcode parametresi ile ürün tanımlanmaktadır. Eğer barkod ile ürün bulunmaz ise, kayıt tutulup ana veri güncellenmektedir. Barkodu tesbit edilemeyen ürünler searchProduct methodu ile aranabilir.
Katlı satış adeti ve minimum satış adeti eklenecekse stokla orantılı olmalıdır.
Example request:
curl -X POST \
"https://api.tedbul.com.tr/api/ads/createAds" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {Token}" \
-d '{"productBarcode":"XXX","productName":"XXX","expiration":"2020-01-01","stock":10,"price":"10,00","psf":"5,00","description":"XXX","featured":1,"minSellQty":1,"maxSellQty":100,"levelOfSales":2, "status": 1}'
$client = new \GuzzleHttp\Client();
$response = $client->post(
'https://api.tedbul.com.tr/api/ads/createAds',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {Token}',
],
'json' => [
'productBarcode' => 'xxx',
'productName' => 'xxx',
'expiration' => '2020-01-31',
'stock' => 10,
'price' => '10,50',
'psf' => '5,50',
'description' => 'xxx',
'featured' => 1,
'minSellQty' => 1,
'maxSellQty' => 100,
'levelOfSales' => 2,
'status' => 1,
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json
url = 'https://api.tedbul.com.tr/api/ads/createAds'
payload = {
'productBarcode' : 'xxx',
'productName' : 'xxx',
'expiration' : '2020-01-31',
'stock' : 10,
'price' : '10,50',
'psf' : '5,50',
'description' : 'xxx',
'featured' : 1,
'minSellQty' : 1,
'maxSellQty' : 100,
'levelOfSales' : 2,
'status' : 1,
}
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {Token}'
}
response = requests.request('POST', url, headers=headers, json=payload)
response.json()
const url = new URL(
"https://api.tedbul.com.tr/api/ads/createAds"
);
let headers = {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {Token}",
};
let body = {
'productBarcode' : 'xxx',
'productName' : 'xxx',
'expiration' : '2020-01-31',
'stock' : 10,
'price' : '10,50',
'psf' : '5,50',
'description' : 'xxx',
'featured' : 1,
'minSellQty' : 1,
'maxSellQty' : 100,
'levelOfSales' : 2,
'status' : 1,
}
fetch(url, {
method: "POST",
headers: headers,
body: body
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"status": true,
"code": 200,
"message": "ok",
"result": {
"adsId": "integer İlan ID",
"productId": "integer Ürün ID",
"productName": "string Ürün Adı",
"barcodes": [
"string Barkod"
],
"price": "decimal Ürün Fiyatı",
"stock": "integer Stok",
"minSellQty": "integer Minimum Satış Adeti",
"maxSellQty": "integer Maximum Satış Adeti",
"levelOfSales": "integer Katlı Satış Adeti",
"description": "string Ürün Açıklaması",
"expiration": "date Miad"
}
}
HTTP Request
POST api/ads/createAds
Body Parameters
Parameter | Type | Status | Description |
---|---|---|---|
productBarcode |
string | required | Ürün Barkodu |
productName |
string | required | Ürün Adı |
expiration |
date | optional | Ürün Miadı YYYY-MM-DD |
stock |
integer | required | min:3 Stok |
price |
decimal | required | Ürün Fiyatı |
psf |
decimal | optional | Piyasa Satış Fiyatı |
description |
string | optional | max:255 Ürün Açıkalaması |
featured |
integer | optional | Öne çıkarılan ilan 0 veya 1 |
minSellQty |
integer | optional | Minimum satış adeti |
maxSellQty |
integer | optional | Maximum satış adeti |
levelOfSales |
integer | optional | Katlı satış adeti |
specialcode |
string | optional | Özel Kod |
status |
integer | optional | Durum : 1 Aktif | 2 Pasif |
İlan Güncelle
Katlı satış adeti ve minimum satış adeti eklenecekse stokla orantılı olmalıdır.
Example request:
curl -X PUT \
"https://api.tedbul.com.tr/api/ads/updateAds" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {Token}" \
-d '{"id":1,"expiration":"2020-01-31","stock":1,"price":"10,50","psf":"5,50","description":"xxx","featured":1,"minSellQty":1,"levelOfSales":1,"status":1}'
$client = new \GuzzleHttp\Client();
$response = $client->put(
'https://api.tedbul.com.tr/api/ads/updateAds',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {Token}',
],
'json' => [
'id' => 1,
'expiration' => '2020-01-31',
'stock' => 1,
'price' => '10,50',
'psf' => '5,50',
'description' => 'xxx',
'featured' => 1,
'minSellQty' => 1,
'levelOfSales' => 1,
'status' => 1,
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json
url = 'https://api.tedbul.com.tr/api/ads/updateAds'
payload = {
"id": 1,
"expiration": "2020-01-31",
"stock": 1,
"price": "10,50",
"psf": "5,50",
"description": "xxx",
"featured": 1,
"minSellQty": 1,
"levelOfSales": 1,
"status": 1
}
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {Token}'
}
response = requests.request('PUT', url, headers=headers, json=payload)
response.json()
const url = new URL(
"https://api.tedbul.com.tr/api/ads/updateAds"
);
let headers = {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {Token}",
};
let body = {
"id": 1,
"expiration": "2020-01-31",
"stock": 1,
"price": "10,50",
"psf": "5,50",
"description": "xxx",
"featured": 1,
"minSellQty": 1,
"levelOfSales": 1,
"status": 1
}
fetch(url, {
method: "PUT",
headers: headers,
body: body
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"status": true,
"code": 200,
"message": "ok",
"result": {
"adsId": "integer İlan ID",
"productId": "integer Ürün ID",
"productName": "string Ürün Adı",
"barcodes": [
"string Barkod"
],
"price": "decimal Ürün Fiyatı",
"stock": "integer Stok",
"minSellQty": "integer Minimum Satış Adeti",
"levelOfSales": "integer Katlı Satış Adeti",
"description": "string Ürün Açıklaması",
"expiration": "date Miad"
}
}
HTTP Request
PUT api/ads/updateAds
Body Parameters
Parameter | Type | Status | Description |
---|---|---|---|
id |
integer | required | İlan ID |
expiration |
date | optional | Ürün Miadı YYYY-MM-DD |
stock |
integer | required | min:3 Stok |
price |
decimal | required | Ürün Fiyatı |
psf |
decimal | optional | Piyasa Satış Fiyatı |
description |
string | optional | max:255 Ürün Açıkalaması |
featured |
integer | optional | Öne çıkarılan ilan 0 veya 1 |
minSellQty |
integer | optional | Minimum satış adeti |
levelOfSales |
integer | optional | Katlı satış adeti |
status |
integer | optional | Durum : 1 Aktif | 2 Pasif |
specialcode |
string | optional | Özel Kod |
Toplu İlan Güncelle
Katlı satış adeti ve minimum satış adeti eklenecekse stokla orantılı olmalıdır.
Toplu olarak tek seferde 100 ilan güncelleyebilirsiniz.
Example request:
curl -X PUT \
"https://api.tedbul.com.tr/api/ads/multipleUpdateAds" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {Token}" \
-d '"adsList": [
{
"id": 1111111111,
"expiration": "2022-01-01",
"stock": 17,
"price": "17,45",
"psf": "0,00",
"description": "xxx",
"productBarcode": "170017341905",
"featured": 0,
"minSellQty": 1,
"levelOfSales": 1,
"status": 1
},
{
"id": 22222222222,
"expiration": "2022-01-01",
"stock": 34,
"price": "105,00",
"psf": "0,00",
"description": "xxx",
"productBarcode": "17001734190500",
"featured": 0,
"minSellQty": 1,
"levelOfSales": 1,
"status": 1
}
]'
$client = new \GuzzleHttp\Client();
$response = $client->put(
'https://api.tedbul.com.tr/api/ads/multipleUpdateAds',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {Token}',
],
'json' => {
"adsList": [
{
"id": 1111111111,
"expiration": "2022-01-01",
"stock": 17,
"price": "17,45",
"psf": "0,00",
"description": "xxx",
"productBarcode": "170017341905",
"featured": 0,
"minSellQty": 1,
"levelOfSales": 1,
"status": 1
},
{
"id": 22222222222,
"expiration": "2022-01-01",
"stock": 34,
"price": "105,00",
"psf": "0,00",
"description": "xxx",
"productBarcode": "17001734190500",
"featured": 0,
"minSellQty": 1,
"levelOfSales": 1,
"status": 1
}
]
}
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json
url = 'https://api.tedbul.com.tr/api/ads/multipleUpdateAds'
payload = {
"adsList": [
{
"id": 1111111111,
"expiration": "2022-01-01",
"stock": 17,
"price": "17,45",
"psf": "0,00",
"description": "xxx",
"productBarcode": "170017341905",
"featured": 0,
"minSellQty": 1,
"levelOfSales": 1,
"status": 1
},
{
"id": 22222222222,
"expiration": "2022-01-01",
"stock": 34,
"price": "105,00",
"psf": "0,00",
"description": "xxx",
"productBarcode": "17001734190500",
"featured": 0,
"minSellQty": 1,
"levelOfSales": 1,
"status": 1
}
]
}
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {Token}'
}
response = requests.request('PUT', url, headers=headers, json=payload)
response.json()
const url = new URL("https://api.tedbul.com.tr/api/ads/multipleUpdateAds");
let headers = {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {Token}",
};
let body = {
"adsList": [
{
"id": 1111111111,
"expiration": "2022-01-01",
"stock": 17,
"price": "17,45",
"psf": "0,00",
"description": "xxx",
"productBarcode": "170017341905",
"featured": 0,
"minSellQty": 1,
"levelOfSales": 1,
"status": 1
},
{
"id": 22222222222,
"expiration": "2022-01-01",
"stock": 34,
"price": "105,00",
"psf": "0,00",
"description": "xxx",
"productBarcode": "17001734190500",
"featured": 0,
"minSellQty": 1,
"levelOfSales": 1,
"status": 1
}
]
}
fetch(url, {
method: "PUT",
headers: headers,
body: body
}).then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"status": true,
"code": 200,
"successCount": 2,
"errorCount": 0
}
HTTP Request
PUT api/ads/multpleUpdateAds
Body Parameters
Parameter | Type | Status | Description |
---|---|---|---|
id |
integer | required | İlan ID |
expiration |
date | optional | Ürün Miadı YYYY-MM-DD |
stock |
integer | required | min:3 Stok |
price |
decimal | required | Ürün Fiyatı |
psf |
decimal | optional | Piyasa Satış Fiyatı |
description |
string | optional | max:255 Ürün Açıkalaması |
featured |
integer | optional | Öne çıkarılan ilan 0 veya 1 |
minSellQty |
integer | optional | Minimum satış adeti |
levelOfSales |
integer | optional | Katlı satış adeti |
status |
integer | optional | Durum : 1 Aktif | 2 Pasif |
specialcode |
string | optional | Özel Kod |
İlan Silme
Example request:
curl -X DELETE \
"https://api.tedbul.com.tr/api/ads/deleteAds" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {Token}" \
-d '{"id":1}'
$client = new \GuzzleHttp\Client();
$response = $client->delete(
'https://api.tedbul.com.tr/api/ads/deleteAds',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {Token}',
],
'json' => [
'id' => 1,
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json
url = 'https://api.tedbul.com.tr/api/ads/deleteAds'
payload = {
"id": 1
}
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {Token}'
}
response = requests.request('DELETE', url, headers=headers, json=payload)
response.json()
const url = new URL(
"https://api.tedbul.com.tr/api/ads/deleteAds"
);
let headers = {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {Token}",
};
let body = {
"id": 1
}
fetch(url, {
method: "DELETE",
headers: headers,
body: body
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"status": true,
"code": 200,
"message": "ok"
}
HTTP Request
DELETE api/ads/deleteAds
Body Parameters
Parameter | Type | Status | Description |
---|---|---|---|
id |
integer | optional | İlan ID |
İlan Listesi
Example request:
curl -X GET \
-G "https://api.tedbul.com.tr/api/ads/getAdsList?page=non&show=dolores&adsStatus=et" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {Token}"
$client = new \GuzzleHttp\Client();
$response = $client->get(
'https://api.tedbul.com.tr/api/ads/getAdsList',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {Token}',
],
'query' => [
'page' => 1,
'show' => 50,
'adsStatus' => 1,
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json
url = 'https://api.tedbul.com.tr/api/ads/getAdsList'
params = {
'page': 1,
'show': 50,
'adsStatus': 1
}
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {Token}'
}
response = requests.request('GET', url, headers=headers, params=params)
response.json()
const url = new URL(
"https://api.tedbul.com.tr/api/ads/getAdsList"
);
let params = {
'page': 1,
'show': 50,
'adsStatus': 1,
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
let headers = {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {Token}",
};
fetch(url, {
method: "GET",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"status": true,
"code": 200,
"message": "ok",
"result": {
"total": "integer Toplam İlan",
"data": [
{
"adsId": "integer İlan ID",
"productId": "integer Ürün ID",
"productName": "string Ürün Adı",
"barcodes": [
"string Barkod"
],
"price": "decimal Fiyat",
"stock": "string Stok",
"minSellQty": "integer Minimum Satış Adeti",
"levelOfSales": "integer Katlı Satış Adeti",
"description": "string İlan Açıklaması",
"expiration": "date Miad",
"status": "integer İlan Durumu"
},
{
"adsId": "integer İlan ID",
"productId": "integer Ürün ID",
"productName": "string Ürün Adı",
"barcodes": [
"string Barkod"
],
"price": "decimal Fiyat",
"stock": "string Stok",
"minSellQty": "integer Minimum Satış Adeti",
"levelOfSales": "integer Katlı Satış Adeti",
"description": "string İlan Açıklaması",
"expiration": "date Miad",
"status": "integer İlan Durumu"
},
{
"adsId": "integer İlan ID",
"productId": "integer Ürün ID",
"productName": "string Ürün Adı",
"barcodes": [
"string Barkod"
],
"price": "decimal Fiyat",
"stock": "string Stok",
"minSellQty": "integer Minimum Satış Adeti",
"levelOfSales": "integer Katlı Satış Adeti",
"description": "string İlan Açıklaması",
"expiration": "date Miad",
"status": "integer İlan Durumu"
}
]
}
}
HTTP Request
GET api/ads/getAdsList
Query Parameters
Parameter | Status | Description | |
---|---|---|---|
page |
optional | int optional Sayfa | Varsayılan: 1 |
show |
optional | int optional Sayfa başına gösterilecek satır | Varsayılan: 50 |
adsStatus |
optional | int optional İlan Durumu 1 Aktif | 2 Pasif |
İlan Detayı
Example request:
curl -X GET \
-G "https://api.tedbul.com.tr/api/ads/getAds/1" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {Token}"
$client = new \GuzzleHttp\Client();
$response = $client->get(
'https://api.tedbul.com.tr/api/ads/getAds/1',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {Token}',
],
'query' => [
'id' => 1,
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json
url = 'https://api.tedbul.com.tr/api/ads/getAds/1'
params = {
'id': 'enim'
}
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {Token}'
}
response = requests.request('GET', url, headers=headers, params=params)
response.json()
const url = new URL(
"https://api.tedbul.com.tr/api/ads/getAds/1"
);
let params = {
"id": "enim",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
let headers = {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {Token}",
};
fetch(url, {
method: "GET",
headers: headers,
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"status": true,
"code": 200,
"message": "ok",
"result": {
"data": {
"adsId": "integer İlan ID",
"productId": "integer Ürün ID",
"productName": "string Ürün Adı",
"barcodes": [
"string Barkod"
],
"price": "decimal Fiyat",
"stock": "string Stok",
"minSellQty": "integer Minimum Satış Adeti",
"levelOfSales": "integer Katlı Satış Adeti",
"description": "string İlan Açıklaması",
"expiration": "date Miad",
"status": "integer İlan Durumu"
}
}
}
HTTP Request
GET api/ads/getAds/{id}
Query Parameters
Parameter | Status | Description |
---|---|---|
id |
required | İlan ID |
5. Ürünler
Ürün Arama
Example request:
curl -X POST \
"https://api.tedbul.com.tr/api/ads/searchProduct" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {Token}" \
-d '{"nameOrBarcode":"xxx"}'
$client = new \GuzzleHttp\Client();
$response = $client->post(
'https://api.tedbul.com.tr/api/ads/searchProduct',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {Token}',
],
'json' => [
'nameOrBarcode' => 'xxx',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json
url = 'https://api.tedbul.com.tr/api/ads/searchProduct'
payload = {
"nameOrBarcode": "xxx"
}
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {Token}'
}
response = requests.request('POST', url, headers=headers, json=payload)
response.json()
const url = new URL(
"https://api.tedbul.com.tr/api/ads/searchProduct"
);
let headers = {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {Token}",
};
let body = {
"nameOrBarcode": "xxx"
}
fetch(url, {
method: "POST",
headers: headers,
body: body
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"status": true,
"code": 200,
"message": "ok",
"result": [
{
"id": "integer Ürün ID",
"name": "string Ürün Adı",
"brand": "integer Marka ID",
"barcodes": [
"string Barkod"
],
"image": "string Ürün Resmi",
"kdv": "integer KDV Oranı",
"minimumListPrice":"decimal En Düşük Liste Fiyatı"
},
{
"id": "integer Ürün ID",
"name": "string Ürün Adı",
"brand": "integer Marka ID",
"barcodes": [
"string Barkod"
],
"image": "string Ürün Resmi",
"kdv": "integer KDV Oranı",
"minimumListPrice":"decimal En Düşük Liste Fiyatı"
},
{
"id": "integer Ürün ID",
"name": "string Ürün Adı",
"brand": "integer Marka ID",
"barcodes": [
"string Barkod"
],
"image": "string Ürün Resmi",
"kdv": "integer KDV Oranı",
"minimumListPrice":"decimal En Düşük Liste Fiyatı"
},
{
"id": "integer Ürün ID",
"name": "string Ürün Adı",
"brand": "integer Marka ID",
"barcodes": [
"string Barkod"
],
"image": "string Ürün Resmi",
"kdv": "integer KDV Oranı",
"minimumListPrice":"decimal En Düşük Liste Fiyatı"
},
{
"id": "integer Ürün ID",
"name": "string Ürün Adı",
"brand": "integer Marka ID",
"barcodes": [
"string Barkod"
],
"image": "string Ürün Resmi",
"kdv": "integer KDV Oranı",
"minimumListPrice":"decimal En Düşük Liste Fiyatı"
}
]
}
HTTP Request
POST api/ads/searchProduct
Body Parameters
Parameter | Type | Status | Description |
---|---|---|---|
nameOrBarcode |
string | optional | Ürün adı veya barkod ile ürün arama yapılabilir. |
5. Kullanıcı
Entegrasyon Verisi Güncelle
Example request:
curl -X PUT \
"https://api.tedbul.com.tr/api/user/integrationdata" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {Token}" \
-d '{"message" : "Basarili","messageType" : 2,"totalAds" : 100,"pullAds" : 50}'
$client = new \GuzzleHttp\Client();
$response = $client->put(
'https://api.tedbul.com.tr/api/user/integrationdata',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'Authorization' => 'Bearer {Token}',
],
'json' => [
"message" : "Basarili",
"messageType" : 2,
"totalAds" : 100,
"pullAds" : 50
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json
url = 'https://api.tedbul.com.tr/api/user/integrationdata'
payload = {
"message" : "Basarili",
"messageType" : 2,
"totalAds" : 100,
"pullAds" : 50
}
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'Authorization': 'Bearer {Token}'
}
response = requests.request('PUT', url, headers=headers, json=payload)
response.json()
const url = new URL(
"https://api.tedbul.com.tr/api/user/integrationdata"
);
let headers = {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {Token}",
};
let body = {
"message" : "Basarili",
"messageType" : 2,
"totalAds" : 100,
"pullAds" : 50
}
fetch(url, {
method: "PUT",
headers: headers,
body: body
})
.then(response => response.json())
.then(json => console.log(json));
Example response (200):
{
"status": true,
"code": 200,
"message": "ok"
}
HTTP Request
PUT api/user/integrationdata
Body Parameters
Parameter | Type | Status | Description |
---|---|---|---|
message |
string | required | Islem mesaji |
messageType |
string | required | Islem Tipi : 1 Basarisiz | 2 Basarili |
totalAds |
string | reuired | Toplam Ilan Sayisi |
pullAds |
string | reuired | Kaydedilen Ilan Sayisi |