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.
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
team | object | hayır | Yalnızca name, timezone ve modules taşır; başka anahtar gönderilirse 422. |
team.name | string | hayır | Çalışma alanının adı, en çok 255 karakter. Gönderilmezse Çalışma Alanım #n adı verilir. |
team.timezone | string | hayır | IANA saat dilimi, örneğin Europe/Istanbul. |
team.modules | array | hayır | Açı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
Ö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.
- PHP
- Node.js
- Python
- Java
- cURL
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
const { team } = await partner.createTeam({
name: 'Kahve Dükkanı',
timezone: 'Europe/Istanbul',
modules: ['api', 'orders'],
});
team.slug; // apiKey, apiSecret ve gatewayUrl ile birlikte saklayın
const client = partner.teamClient(team); // çalışma alanının kendi anahtarıyla Client
from odemehub.request import CreateTeam
team = partner.create_team(CreateTeam(
name="Kahve Dükkanı",
timezone="Europe/Istanbul",
modules=["api", "orders"],
)).team
team.slug # api_key, api_secret ve gateway_url ile birlikte saklayın
client = partner.team_client(team) # çalışma alanının kendi anahtarıyla Client
import com.odemehub.Client;
import com.odemehub.request.CreateTeam;
var team = partner.createTeam(CreateTeam.builder()
.name("Kahve Dükkanı")
.timezone("Europe/Istanbul")
.modules("api", "orders")
.build()).getTeam();
team.getSlug(); // getApiKey(), getApiSecret() ve getGatewayUrl() ile birlikte saklayın
Client client = partner.teamClient(team); // çalışma alanının kendi anahtarıyla Client
URI_PATH="/api/partner/create-team"
BODY='{"team":{"name":"Kahve Dükkanı","timezone":"Europe/Istanbul","modules":["api","orders"]}}'
TIMESTAMP=$(date +%s)
SIGNATURE=$(printf '%s\n%s\n%s\n%s' "$TIMESTAMP" "POST" "$URI_PATH" "$BODY" | openssl dgst -sha256 -hmac "$ODEMEHUB_PARTNER_API_SECRET" | sed 's/^.* //')
curl -X POST "https://sandbox.odemehub.com$URI_PATH" \
-H "Content-Type: application/json" \
-H "X-Api-Key: $ODEMEHUB_PARTNER_API_KEY" \
-H "X-Timestamp: $TIMESTAMP" \
-H "X-Signature: $SIGNATURE" \
--data-raw "$BODY"
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
| Alan | Tip | Açıklama |
|---|---|---|
slug | string | Çalışma alanının on haneli numarası; gateway adresinde {team} ve iş ortağı uçlarında {slug} olarak kullanılır. |
name | string | Çalışma alanının adı. |
timezone | string | Saat dilimi. |
is_test | boolean | Çalışma alanı test modundaysa true. Yeni çalışma alanı test modunda açılır. |
modules | array | Açık modüller. ödemehub'ın açtığı custom_domain ve shopify_pos da burada görünür. |
gateway_url | string | Çalışma alanının gateway adresi; uçlar bunun sonuna eklenir ({gateway_url}/create-order). |
api_key | string | Çalışma alanının API anahtarı. |
api_secret | string | Çalışma alanının gizli anahtarı; istekleri imzalar, yanıtları ve webhook'ları doğrular. |
created_at | string | Açılış anı, ISO 8601, UTC. |
HTTP durum kodları
| Kod | Durum |
|---|---|
200 | Çalışma alanı açıldı. |
401 | İş ortağı anahtarı ya da imza geçersiz. |
422 | Doğrulama hatası ya da çalışma alanı sınırına ulaşıldı. |
429 | Dakikada 60 istek sınırı aşıldı. |
Hatalar
| Alan | Mesaj |
|---|---|
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) |