Müşteri · Ayarlar

API anahtarı oluşturma

Kendi yazılımınızı (sipariş, ERP, depo sistemi) Courino'ya bağlamak için API anahtarı oluşturma, geliştiriciye iletme ve iptal etme.

API anahtarı, kendi yazılımınızın sizin adınıza fiyat almasını ve sipariş açmasını sağlayan gizli bir şifredir. Anahtarı siz oluşturursunuz, yazılım geliştiricinize iletirsiniz; geliştirici onu her isteğe ekler.

Bu kartı görmüyorsanız hesabınızda API ve webhook izni yoktur. Kurye firmanızdan bu izni isteyin.

Anahtar oluşturma

Sol menüden Bilgilerim'e basın.
Aşağıdaki Entegrasyon (API anahtarları) kartını bulun.
Kutuya anahtarın nerede kullanılacağını yazın (ör. "ERP" ya da "Web sitesi"). Bu ad, ileride hangi anahtarın neye ait olduğunu anlamanızı sağlar.
Anahtar oluştur'a basın.
Yeşil kutuda kosk_ ile başlayan anahtar görünür. Kopyala'ya basıp anahtarı alın.
Anahtarı geliştiricinize güvenli bir yoldan iletin (ör. şifre yöneticisi). E-postayla ya da mesajla açık yazmayın.

Anahtar yalnızca bir kez gösterilir. Sayfayı kapattıktan sonra yeniden göremezsiniz; kaybederseniz yeni anahtar oluşturun.

Geliştiricinin bilmesi gerekenler

Anahtar her istekte Authorization: Bearer kosk_… başlığıyla gönderilir.
Anahtar, oluşturan hesabın izinleriyle çalışır: o hesap sipariş veremiyorsa anahtar da veremez.
Anahtar şifreye, kartlara ve hesap ayarlarına dokunamaz, ödeme başlatamaz ve destek talebi açamaz. Ödemelerinizi ve ekstrenizi yalnız okuyabilir.
Kartın sağ üstündeki API dokümanı düğmesi, tüm uçları anlatan ve tarayıcıdan denenebilen dokümanı açar. Ayrıntılar Entegrasyon API'si yazısında.

Anahtarları yönetme

Kartın altındaki listede her anahtarın adı, son 8 karakteri (ör. kosk_…Xk3p9QaZ), oluşturulma zamanı ve son kullanım zamanı görünür. Hangi anahtarın hangisi olduğunu, elinizdeki anahtarın son karakterleriyle karşılaştırarak bulursunuz.

Her sistem için ayrı anahtar oluşturun. Böylece birini kapatınca diğerleri çalışmaya devam eder.
Aynı anda en çok 5 etkin anahtarınız olabilir. Yer açmak için kullanmadığınızı iptal edin.
Kullanmadığınız ya da başkasının eline geçtiğinden şüphelendiğiniz anahtarın yanındaki İptal'e basın. Anahtar en geç 30 saniye içinde çalışmaz olur. İptal geri alınamaz.

Şifre değişince

Hesabınızın şifresi değişince o hesabın anahtarlarının hepsi iptal edilir: kendiniz değiştirdiğinizde, kurye firmanız sıfırladığında ya da Şifremi unuttum ile yenilediğinizde. Bu, şifresi ele geçen bir hesabın anahtarlarının da kapanması içindir. Şifre değişikliğinden sonra yeni anahtar oluşturup geliştiricinize iletin.

Sorun mu var?

Entegrasyon kartı görünmüyor: Hesabınıza API ve webhook izni verilmemiştir. Kurye firmanıza danışın.
Anahtarı kopyalamayı unuttum: Anahtar bir daha gösterilmez. Eskisini İptal edip yeni anahtar oluşturun.
Entegrasyon birden çalışmayı bıraktı: Şifreniz değişmiş ya da anahtar iptal edilmiş olabilir. Listede anahtarın yanında iptal yazıyorsa yeni anahtar oluşturun.
Anahtar oluştur düğmesi çalışmıyor: Önce kutuya bir ad yazın. 5 etkin anahtarınız varsa birini iptal edin.
Geliştirici "429" hatası alıyor: Bir anahtarla dakikada en çok 120 istek gönderilebilir. Geliştiriciniz istekleri yavaşlatmalı ya da yanıttaki bekleme süresine uymalıdır.