API anahtarları
Web sitenizi ya da yazılımınızı Measure Map Online'a bağlayan anahtarı oluşturun, neler yapabileceğini seçin, canlı ve test çalışmalarını birbirinden ayırın; anahtarı güvenle değiştirin ve kısıtlayın.
Bir API anahtarı, kendi web sitenizin ya da yazılımınızın Measure Map Online hesabınızla çalışmasını sağlar: bir projenin haritasını sitenizde göstermek, ziyaretçileriniz için proje başlatmak ya da projeleri REST API ile okuyup değiştirmek gibi. Anahtarları Geliştirici sayfasında oluşturur ve yönetirsiniz.
Geliştirici sayfasını açın#
Kontrol paneli menüsünde, Gelişmiş altında Geliştirici düğmesine basın. Sayfa API anahtarları bölümüyle açılır; diğer bölümleri menüde altında sıralanır (telefonda sayfanın üstünde sekmeler olarak):
- Misafir bağlantısı (Open Guest): web siteniz için kodsuz bağlantı. Bkz. Open Guest.
- API'yi deneyin, Webhook'lar ve REST API: bkz. API başvurusu.
- Harita göm (Enterprise): bkz. iFrame API.
- Özel projeler (Enterprise): müşterilerin özel projelerini yerleşik haritalarınızda gösterin. Bkz. müşterilerin özel projeleri.
Anahtar kartının üstündeki rozet, anahtarınızın Aktif, Etkinleştirilmedi (henüz anahtar yok), Devre dışı (API erişimi askıya alınmış: hiçbir anahtar çalışmaz ve destek ekibi kaldırana kadar yeni anahtar oluşturulamaz) ya da Süresi dolmuş (abonelik etkin değil) olduğunu söyler.
Canlı ve Sandbox#
Anahtar kartının üstünde Canlı ile Sandbox arasında geçiş yapın. Her birinin kendi anahtarı vardır ve sayfa seçtiğinizi gösterir. Seçim API'yi deneyin içinde de geçerlidir ve bölümler arasında gezinirken korunur. Harita göm ve Misafir bağlantısı her zaman canlı anahtarınızı kullanır, çünkü web sitenizin ziyaretçileri yalnızca canlı projeleri açabilir: bunlardan birini açmak sayfayı yeniden Canlı konumuna getirir.
- Canlı gerçek hesabınızdır ve sayfa onunla açılır. Web sitenizde canlı anahtar kullanın.
- Sandbox bir entegrasyonu geliştirmek ve test etmek içindir. Bir sandbox anahtarıyla oluşturulan projeler, klasörler ve ürünler gerçeklerinden ayrı tutulur: canlı anahtar onları göremez, sandbox anahtarı da canlı olanları göremez. Sandbox anahtarıyla yapılan istekler kullanım rakamlarınıza sayılmaz ve onunla oluşturulan misafir projeleri hiçbir zaman faturalandırılmaz.
Yeni bir sandbox anahtarı oluşturmak canlı anahtarınızı hiçbir zaman etkilemez, tersi de geçerlidir.
Anahtarın neler yapabileceğini seçin#
Anahtar oluşturduğunuzda, pencere API'nin her alanını Yeni anahtarın erişimi altında listeler. Yeni anahtarın her birine ne kadar erişeceğini seçin:
| Alan | Seçenekler | İzin verdiği |
|---|---|---|
| Gömülü haritalar (Enterprise) | Erişim yok, İzin verilir | Bir görüntüleyiciyi gömülü haritada oturum açtırır. Çoğu entegrasyon yalnızca buna ihtiyaç duyar. |
| Misafir projeleri (Open Guest) | Erişim yok, İzin verilir | Sunucunuzdan alınan bir belirteçle bir ziyaretçi için misafir projesi başlatır. Çoğu entegrasyon yalnızca buna ihtiyaç duyar. |
| Projeler | Erişim yok, Okuma, Okuma ve değiştirme | Projeler ve klasörler; ölçümleri, yorumları ve dışa aktarmalarıyla. |
| Kullanıcılar (Enterprise) | Erişim yok, Okuma, Okuma ve değiştirme | Kuruluşunuzun kullanıcıları ile davetleri, kullanıcı lisansları ve ekipleri. |
| Kuruluş (Enterprise) | Erişim yok, Okuma, Okuma ve değiştirme | Kuruluşunuzun profili, politikası, çoklu oturum açması ve etkinlik günlüğü ile kullanıcı lisansları. |
| Ürünler | Erişim yok, Okuma, Okuma ve değiştirme | Ürün kataloğunuz ve fiyatları. |
| Misafirler (Open Guest) | Erişim yok, Okuma, Okuma ve değiştirme | Misafir bağlantınız, misafir projeleri ve teklif talepleri, misafirlerinizin iletişim bilgileri ve bütçeniz. |
| Hesap | Erişim yok, Okuma, Okuma ve değiştirme | Planınız, kullanıcı lisanslarınız, API kullanımınız, profiliniz ve e-posta ayarlarınız; Open Guest'te harcamanız ve bütçeniz. |
| Geliştirici | Erişim yok, Okuma, Okuma ve değiştirme | API anahtarlarınız ve webhook'unuz. Bir anahtar asla kendi erişiminin ötesine geçmez. |
| Müşteriler (iş ortağı) | Erişim yok, Okuma, Okuma ve değiştirme | Müşterileriniz, onlar için ödediğiniz planlar, davetleri ve faturaları. |
Pencere yalnızca planınızın içerdiği alanları gösterir. Tam olarak neye izin verdiğini görmek için fareyi bir seçeneğin üzerinde tutun. İlk anahtarınız yalnızca Gömülü haritalar ile başlar; bu, yerleşik bir harita için gereken tek şeydir. Başka bir anahtarın yerine geçen anahtar, o anahtarın erişimiyle başlar. En az bir alan seçin.
Bir anahtarın neler yapabileceği, oluşturulduğu anda belirlenir. Bir anahtara daha fazla ya da daha az erişim vermek için yenisini oluşturun.
Anahtar oluşturun#
- Anahtar kartının üstünde Canlı ya da Sandbox seçin.
- Yeni anahtar oluştur düğmesine basın. Bir pencere açılır; başlığının yanında Canlı ya da Sandbox görünür.
- Erişimi Yeni anahtarın erişimi altında ayarlayın (bkz. yukarısı).
- İsterseniz anahtarlarınızı birbirinden ayırt etmek için Yeni anahtarın adı (isteğe bağlı) alanına bir ad yazın.
- Oluştur düğmesine basın.
Pencere ardından şunu söyler: Yeni anahtarınız hazır. Bu sayfadan istediğiniz zaman yeniden kopyalayabilirsiniz. Anahtarı, ilk ve son karakterleri dışında gizlenmiş olarak ve neler Yapabilecekleri gösterir. Tamamını görmek için , anahtarın tamamını kopyalamak için simgesine basın, sonra Bitti düğmesine basın. Anahtar kartı, anahtarı API anahtarınız altında aynı şekilde gösterir. Hesabınızda her anahtar oluşturulduğunda bir e-posta alırsınız.
Erişim ayarlarından önce oluşturulan anahtarlar#
Anahtarlarda erişim ayarları olmadan önce oluşturulmuş bir anahtar, ürünlerle çalışmak dışında her şeyi yapabilir. Bu tür anahtarlar emekliye ayrılıyor: anahtar kartı, anahtarınızın ne zaman çalışmayı bırakacağını söyler ve bir bildirim de alırsınız. Kartın o zaman ana düğme olarak gösterdiği Yeni anahtar oluştur düğmesine basın ve eski anahtarı o tarihten önce web sitenizde ya da sunucunuzda değiştirin. Pencere yalnızca Gömülü haritalar ile başlar; sunucunuzun gereksinimi daha fazlaysa daha fazlasını seçin.
Anahtarı değiştirin#
Bir anahtarınız varken Yeni anahtar oluştur düğmesine yeniden basın ve yenisini pencerede oluşturun. Pencere, mevcut anahtara ne olacağını söyler: Yeni bir anahtar oluşturulacak ve mevcut anahtarınız 24 saat çalışmaya devam edecek; böylece onu kullanan siteleri güncelleyebilirsiniz. İşiniz bitince daha erken iptal edebilirsiniz. Erişim ayarlarından önce oluşturulmuş bir anahtar, bunun yerine size verilen tarihe kadar çalışmaya devam eder.
Eski anahtar, kalan süresi, son kullanıldığı zaman ve neler yapabildiğiyle birlikte Önceki anahtarlar bölümüne taşınır. Yeni anahtarı kullanıma alırken hâlâ kabul edilir. Hiçbir şey kullanmadığında hemen iptal edin. Hemen durdurmak için İptal et düğmesine basıp onaylayın; onu hâlâ kullanan her site hemen çalışmayı bırakır. Bir anahtar iptal edildiğinde bir e-posta alırsınız.
Web sitesi kısıtlamalarınız yeni anahtara kopyalanır. Yaklaşık dakikada bir yeni anahtar oluşturabilirsiniz.
Anahtarı web sitelerinizle sınırlayın#
Anahtarınızı bir tarayıcıda yalnızca bu listedeki web siteleri kullanabilir: gömülü haritalar ve başka sitelerdeki sayfalardan gelen istekler reddedilir. Sunucudan yapılan çağrılar etkilenmez.
- Web sitesi kısıtlamaları altında, sitenizi
Bir web sitesi veya alan adı girin alanına yazın:
example.comgibi bir alan adı, bir IP adresi ya dalocalhost. Tam bir adres yapıştırabilirsiniz:https://, yol ve bağlantı noktası olmadan yalnızca sitenin adı tutulur. - Ekle düğmesine basın.
Bir alan adı alt alan adlarını da kapsar: example.com, shop.example.com
adresine de izin verir. Bir siteyi kaldırmak için
simgesine basıp onaylayın; sonuncusundan sonra anahtar her web sitesinden
çalışır. Bir anahtardan web sitesi kaldırıldığında her seferinde bir e-posta
alırsınız.
Liste tarayıcılar için geçerlidir. Yerleşik bir harita yalnızca listedeki bir web sitesinin sayfasında açılır; tarayıcı hangi sayfada olduğunu söylemiyorsa reddedilir. Bir web sayfasından gönderilen REST API isteği listedeki bir web sitesinden gelmelidir. Kendi sunucunuzdan gelen istek bir web sitesi belirtmez ve denetlenmez. Measure Map Online'ın kendisine her zaman izin verilir; böylece bu sayfadaki önizlemeler çalışmaya devam eder.
Anahtarın nasıl kullanıldığını görün#
Kullanım, tüm canlı anahtarlarınızı toplar; böylece bir anahtarı değiştirdiğinizde rakamlar kesintisiz sürer. Yerleşik haritalardan ve REST API'den gelen son 30 günün isteklerini, her gün için bir çubukla; toplam Tüm zamanlar değerini; Son erişim değerini; geçerli anahtarın oluşturulduğu zamanı (Anahtar oluşturuldu) ve En çok kullanılan alan adları değerini, yani anahtarlarınızı en çok kullanan web sitelerini gösterir. Orada tanımadığınız bir web sitesi görmek, anahtarı kısıtlamak ya da değiştirmek için bir nedendir.
Sandbox istekleri sayılmaz; bu yüzden rakamlar yalnızca Canlı altında görünür. Bu sayfanın kendi yaptığı istekler de, yani API'yi deneyin ve önizlemelerdekiler de sayılmaz.
Anahtarınızı güvende tutun#
- Her anahtara yalnızca ihtiyaç duyduğu erişimi verin. Bir web sayfasındaki anahtar (örneğin yerleşik haritanın adresindeki) yalnızca Gömülü haritalar erişimine sahip olmalıdır.
- Bu anahtar verilerinizi değiştirebilir. Sunucunuzda tutun; bir web sayfasına veya uygulamaya asla koymayın.
- Web sayfalarında kullanılan bir anahtarı yalnızca kendi web sitelerinizle sınırlayın.
- Ekranınızı paylaşırken anahtarı sayfada gizli bırakın; kopyalamak için gösterilmesi gerekmez.
- Bir anahtar sızmış olabilirse yeni bir anahtar oluşturun ve eskisini hemen Önceki anahtarlar altında iptal edin.
- Denemelerin gerçek projelerinizin arasına karışmaması için Sandbox anahtarıyla geliştirin ve test edin.
Hâlâ yardıma mı ihtiyacınız var?
Destek ekibimize yazın ve ne yapmaya çalıştığınızı anlatın. Ekran görüntüleri yardımcı olur.