Ana içeriğe geç

create-team

POST /api/partner/create-team

İş ortağı adına yeni bir çalışma alanı açar ve istenen modülleri açar. Yanıt, çalışma alanının gateway adresini (gateway_url) ve anahtarlarını (api_key, api_secret) taşır; çalışma alanının içindeki her iş bunlarla yapılır. Akış: İş Ortakları rehberi.

Her istek yeni bir çalışma alanı açar; aynı adla gönderilen istek de yeni bir çalışma alanı açar.

Kimlik doğrulama​

İş ortağı anahtarıyla: X-Api-Key, X-Timestamp, X-Signature, Content-Type: application/json. Ayrıntılar: İş ortağı anahtarı.

İstek​

{
"team": {
"name": "Kahve Dükkanı",
"timezone": "Europe/Istanbul",
"modules": ["api", "orders", "payment_links", "bank_transactions"]
}
}

Bütün alanlar isteğe bağlıdır; {} gönderilirse çalışma alanı varsayılan adla ve modülsüz açılır.

AlanTipZorunluAçıklama
teamobjecthayırYalnızca name, timezone ve modules taşır; başka anahtar gönderilirse 422.
team.namestringhayırÇalışma alanının adı, en çok 255 karakter. Gönderilmezse Çalışma Alanım #n adı verilir.
team.timezonestringhayırIANA saat dilimi, örneğin Europe/Istanbul.
team.modulesarrayhayırAçılacak modüller: api, orders, subscription, payment_links, saved_cards, bank_transactions. Her biri bir kez. Sandbox'ta dikkate alınmaz; orada bütün modüller açıktır.

SDK örnekleri​

not

Örneklerdeki $partner / partner nesnesi iş ortağı anahtarıyla kurulan PartnerClient'tır; kurulumu: İş ortağı anahtarı. teamClient / team_client, açılan çalışma alanının kendi anahtarıyla bir $client / client kurar; ayrıntılar: İstemciyi Kurmak.

use Gurmehub\Odemehub\Request\CreateTeam;

$team = $partner->createTeam(new CreateTeam(
name: 'Kahve Dükkanı',
timezone: 'Europe/Istanbul',
modules: ['api', 'orders'],
))->team;

$team->slug; // apiKey, apiSecret ve gatewayUrl ile birlikte saklayın

$client = $partner->teamClient($team); // çalışma alanının kendi anahtarıyla Client

Yanıt​

{
"result": { "successful": true, "message": null },
"team": {
"slug": "4829103756",
"name": "Kahve Dükkanı",
"timezone": "Europe/Istanbul",
"is_test": true,
"modules": ["api", "orders"],
"gateway_url": "https://sandbox.odemehub.com/api/4829103756/gateway",
"api_key": "key_...",
"api_secret": "secret_...",
"created_at": "2026-11-05T09:30:00.000000Z"
}
}

Çalışma alanı nesnesi​

AlanTipAçıklama
slugstringÇalışma alanının on haneli numarası; gateway adresinde {team} ve iş ortağı uçlarında {slug} olarak kullanılır.
namestringÇalışma alanının adı.
timezonestringSaat dilimi.
is_testbooleanÇalışma alanı test modundaysa true. Yeni çalışma alanı test modunda açılır.
modulesarrayAçık modüller. ödemehub'ın açtığı custom_domain ve shopify_pos da burada görünür.
gateway_urlstringÇalışma alanının gateway adresi; uçlar bunun sonuna eklenir ({gateway_url}/create-order).
api_keystringÇalışma alanının API anahtarı.
api_secretstringÇalışma alanının gizli anahtarı; istekleri imzalar, yanıtları ve webhook'ları doğrular.
created_atstringAçılış anı, ISO 8601, UTC.

HTTP durum kodları​

KodDurum
200Çalışma alanı açıldı.
401İş ortağı anahtarı ya da imza geçersiz.
422Doğrulama hatası ya da çalışma alanı sınırına ulaşıldı.
429Dakikada 60 istek sınırı aşıldı.

Hatalar​

AlanMesaj
teamİş ortaklığınızla en fazla {sınır} çalışma alanı açabilirsiniz.
team.modules.*Bu modülü iş ortağı açamaz. (custom_domain, shopify_pos ya da tanınmayan bir değer)