create-logo
POST /api/{team}/gateway/create-logo
Logoyu base64 olarak alır, saklar ve adresini döner. Logo yüklenince tasarım değişmez; dönen adres update-checkout-design isteğinde logo olarak gönderilir.
Bu uca, genel istek sınırına ek olarak, dakikada en fazla 30 istek kabul edilir.
Yalnızca iş ortağının açtığı çalışma alanlarında çalışır; diğerleri 403 alır. Bkz. İş Ortakları.
Kimlik doğrulama
Çalışma alanının anahtarıyla: X-Api-Key, X-Timestamp, X-Signature, Content-Type: application/json. Ayrıntılar: Kimlik Doğrulama ve İmza.
İstek
{
"logo": {
"content": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
}
}
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
logo.content | string | evet | Görselin base64 hâli; başında data:image/...;base64, olabilir. JPG, PNG ya da WEBP; en fazla 2 MB ve 3000×3000 piksel. |
SDK örnekleri
not
Örneklerdeki $client / client nesnesinin kurulumu: İstemciyi Kurmak.
- PHP
- Node.js
- Python
- Java
- cURL
use Gurmehub\Odemehub\Request\CreateLogo;
use Gurmehub\Odemehub\Request\UpdateCheckoutDesign;
$logo = $client->createLogo(CreateLogo::fromBytes(file_get_contents('logo.png'))); // ya da new CreateLogo($base64)
$client->updateCheckoutDesign(new UpdateCheckoutDesign(logo: $logo->url));
import { readFile } from 'node:fs/promises';
const { url } = await client.createLogo({ content: await readFile('logo.png') }); // bayt ya da base64 metin
await client.updateCheckoutDesign({ logo: url });
from pathlib import Path
from odemehub.request import CreateLogo, UpdateCheckoutDesign
logo = client.create_logo(CreateLogo.from_bytes(Path("logo.png").read_bytes())) # ya da CreateLogo(content=base64_text)
client.update_checkout_design(UpdateCheckoutDesign(logo=logo.url))
import com.odemehub.request.CreateLogo;
import com.odemehub.request.UpdateCheckoutDesign;
import java.nio.file.Files;
import java.nio.file.Path;
var logo = client.createLogo(CreateLogo.fromBytes(Files.readAllBytes(Path.of("logo.png")))); // ya da new CreateLogo(base64)
client.updateCheckoutDesign(UpdateCheckoutDesign.builder().logo(logo.getUrl()).build());
URI_PATH="/api/$ODEMEHUB_TEAM/gateway/create-logo"
BODY=$(printf '{"logo":{"content":"%s"}}' "$(base64 -w0 logo.png)")
TIMESTAMP=$(date +%s)
SIGNATURE=$(printf '%s\n%s\n%s\n%s' "$TIMESTAMP" "POST" "$URI_PATH" "$BODY" | openssl dgst -sha256 -hmac "$ODEMEHUB_API_SECRET" | sed 's/^.* //')
curl -X POST "https://sandbox.odemehub.com$URI_PATH" \
-H "Content-Type: application/json" \
-H "X-Api-Key: $ODEMEHUB_API_KEY" \
-H "X-Timestamp: $TIMESTAMP" \
-H "X-Signature: $SIGNATURE" \
--data-raw "$BODY"
Yanıt
{
"result": { "successful": true, "message": null },
"logo": { "url": "https://app.odemehub.com/storage/12/logos/Yw3k...png" }
}
| Alan | Tip | Açıklama |
|---|---|---|
logo.url | string | Logonun adresi; update-checkout-design'da logo olarak gönderilir. |
HTTP durum kodları
| Kod | Durum |
|---|---|
200 | Logo saklandı. |
401 | API anahtarı ya da imza geçersiz. |
403 | Çalışma alanı işlem yapamıyor ya da bir iş ortağının açtığı çalışma alanı değil: Bu uç yalnızca iş ortağı çalışma alanlarına açıktır. |
422 | Doğrulama hatası: görsel okunamadı ya da kurallara uymuyor. |
429 | Dakikada 30 istek sınırı ya da genel istek sınırı aşıldı. |
Hatalar
| Alan | Mesaj |
|---|---|
logo.content | Logo base64 olarak okunamadı. |