Kurye firması · Ayarlar

Firma API anahtarı

Kendi yazılımınızı (ERP, muhasebe, çağrı merkezi) Courino'ya bağlamak için firma API anahtarı açma, kapsam seçme, güvenli saklama ve iptal etme.

Firma API anahtarı, firmanızın kendi yazılımının (ERP, muhasebe programı, çağrı merkezi, kendi raporlama aracınız) Courino'daki siparişlerinizi, müşterilerinizi ve kuryelerinizi okuyup işlem yapabilmesini sağlayan gizli bir şifredir. Anahtarı siz açarsınız, yazılımcınıza iletirsiniz; yazılım onu her isteğe ekler.

Bu sekmeyi yalnız firma sahibi görür. Yönetici, operatör ve muhasebe hesaplarında yoktur; Albiferro destek oturumunda da açılamaz.

Müşterilerinizin kendi yazılımı için ayrı bir anahtar vardır: müşteri onu portaldan kendisi oluşturur. Ayrıntı: Müşteri kartı. Bu yazı, firmanızın kendi anahtarını anlatır.

Anahtar açma

Sol menüden Yönetim › Ayarlar'a basın.
Üstteki sekmelerden API anahtarları'nı seçin.
Sağ üstteki Yeni anahtar'a basın.
Anahtar adı kutusuna anahtarın nerede kullanılacağını yazın (ör. "ERP" ya da "Muhasebe"). Bu ad, ileride hangi anahtarın neye ait olduğunu anlamanızı sağlar.
Kapsamlar listesinden yazılımın ihtiyaç duyduğu işleri işaretleyin (aşağıda anlatılıyor).
İsterseniz Bitiş tarihi seçin. O günün sonunda anahtar kendiliğinden çalışmaz olur. Boş bırakırsanız siz iptal edene kadar çalışır.
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 yalnızca bir kez gösterilir. Kutuyu kapattıktan ya da sayfadan çıktıktan sonra yeniden göremezsiniz. Kaybederseniz eskisini iptal edip yeni anahtar açın.

Kapsam seçimi

Kapsam, anahtarın hangi işleri yapabileceğini belirler. Anahtar sizin adınıza çalışır ama yalnız seçtiğiniz kapsamlarla. Yazılımın gerçekten ihtiyaç duyduğundan fazlasını seçmeyin: anahtar bir gün başkasının eline geçerse zarar o kadarla sınırlı kalır.

Kapsam	Ne yapabilir
Siparişleri okuma (`orders:read`)	Sipariş listesi ve ayrıntısı, geçmişi, dışa aktarma, ekler, takip bağlantısı
Sipariş açma (`orders:create`)	Yeni sipariş açma ve fiyat sorma
Siparişleri yönetme (`orders:manage`)	Siparişi düzenleme, iptal, kuryeye verme / geri alma, onay / ret
Müşterileri okuma (`customers:read`)	Müşteri listesi, kartı ve yetkilileri
Müşterileri yönetme (`customers:manage`)	Müşteri açma ve düzenleme
Kuryeleri okuma (`couriers:read`)	Kurye listesi, kartı ve anlık konumları
Fiyatları okuma (`pricing:read`)	Semtler, gidiş tipleri, fiyat listeleri ve fiyat sorma
Cari ve hakedişi okuma (`billing:read`)	Cari hesap, tahsilatlar, ücretler ve aylık hakediş

Örnekler:

Yalnız rapor alan bir muhasebe programı için Siparişleri okuma ve Cari ve hakedişi okuma yeter.
Telefonla gelen siparişi kendi ekranından açan bir çağrı merkezi için Sipariş açma, Fiyatları okuma ve Müşterileri okuma seçin.

Anahtar hiçbir kapsamla ayarlara, kullanıcılara, şifrelere, ödeme ve aidat işlemlerine dokunamaz. Kapsamı sonradan değiştiremezsiniz; farklı kapsam gerekirse yeni anahtar açıp eskisini iptal edin.

Anahtarı güvenli saklama

Anahtarı yazılımcınıza bir şifre yöneticisiyle ya da şifreli bir kanaldan iletin. E-postaya, WhatsApp'a ya da mesaja açık yazmayın.
Anahtarı web sitenizin sayfa koduna ya da telefon uygulamasına koymayın; yalnız sunucuda dursun.
Her yazılım için ayrı anahtar açın. 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.
Listede her anahtarın adı, son 8 karakteri (ör. kosk_…Xk3p9QaZ), kapsamları, oluşturanı, oluşturma, son kullanım ve bitiş zamanı görünür. Hiç kullanılmayan ya da beklenmedik zamanda kullanılan anahtarı iptal edin.

Anahtarı iptal etme

Ayarlar › API anahtarları sekmesini açın.
Listede anahtarı adından ve son karakterlerinden bulun.
Satırın sonundaki İptal'e basın ve onaylayın.

Anahtar en geç 30 saniye içinde çalışmaz olur ve listede iptal olarak görünür. İptal geri alınamaz.

Telefondan

Anahtarları Courino uygulamasından da yönetebilirsiniz (yalnız firma sahibi):

Uygulamada Profil sekmesine dokunun.
Hesap bölümünde API anahtarları'nı açın.
Listeyi görür, yeni anahtar açar ya da bir anahtarı iptal edersiniz. Yeni anahtar burada da yalnız bir kez gösterilir.

Şifre değişince

Firma sahibinin şifresi değişince firma API anahtarlarının hepsi iptal edilir: kendiniz değiştirdiğinizde 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 açıp yazılımcınıza iletin.

Ayrıca hesabınız pasife alınırsa ya da firma sahipliği başka birine devredilirse anahtarlar çalışmaz. Yeni sahip kendi anahtarlarını açmalıdır.

Yazılımcının bilmesi gerekenler

Adreslerin hepsi https://admin.courino.com/api/v1 altındadır.
Anahtar her istekte Authorization: Bearer kosk_… başlığıyla gönderilir.
Örnek istek (siparişleri listeler, Siparişleri okuma kapsamı gerekir): curl https://admin.courino.com/api/v1/orders -H "Authorization: Bearer kosk_…"
Bir anahtarla dakikada en çok 120 istek gönderilebilir. Sınır aşılırsa yanıt 429 olur; yanıttaki Retry-After süresi kadar beklenmelidir.
Kapsamı olmayan bir işlem 403 döner.
Sekmenin sağ üstündeki API dokümanı düğmesi tüm uçları anlatan, tarayıcıdan denenebilen dokümanı açar (client.courino.com/api/docs). Genel bilgi: courino.com/gelistiriciler.

Sorun mu var?

API anahtarları sekmesi görünmüyor: Bu sekmeyi yalnız firma sahibi görür. Yönetici hesabıyla girdiyseniz firma sahibine danışın.
Anahtarı kopyalamayı unuttum: Anahtar bir daha gösterilmez. Eskisini İptal edip yeni anahtar açın.
Entegrasyon birden çalışmayı bıraktı: Şifreniz değişmiş, anahtar iptal edilmiş ya da bitiş tarihi geçmiş olabilir. Listede iptal ya da süresi doldu yazıyorsa yeni anahtar açın.
Yeni anahtar düğmesi kapalı: 5 etkin anahtarınız var. Kullanmadığınız birini iptal edin.
Yazılımcı "403" hatası alıyor: Anahtarda o işin kapsamı yok. Doğru kapsamlarla yeni anahtar açın.
Yazılımcı "429" hatası alıyor: Dakikada 120 istek sınırı aşıldı. Yazılım istekleri yavaşlatmalıdır.