Bu kılavuz, ConnectedCooking’de REST API’ye nasıl başlanacağını kısaca açıklamaktadır. Lütfen bu kılavuzun yalnızca Bulut REST API çözümlerimizi ele aldığını unutmayın.
- Öncelikle, ConnectedCooking hesabımızda bir API İstemcisi oluşturmanız gerekiyor. Bunun için ConnectedCooking hesabımızda “Yönetim” sekmesine gidiyoruz.
- Ardından “Entegrasyonlar” seçeneğine tıklayın. “API” sekmesi yalnızca Hesap Yöneticileri tarafından görülebilir.
- Ardından “+ Yeni ekle” seçeneğine tıklayın
- Bir sonraki ekranda bir “ALIAS” girin, bir GRUP atayın ve bir API türü seçin. HACCP ile ilgili API sorguları ve ConnectedCooking hesabınızdaki veriler için “Base API” API türünü seçmeniz gerekir. Tüm alanları doldurduktan sonra “API Ekle” seçeneğine tıklayın.
- Bir sonraki ekranda API istemci kimlik bilgilerinizi alacaksınız. Lütfen bunları güvenli bir yerde saklayın ve “Kapat” düğmesine tıklayın.
- API istemcinizi oluşturduktan sonra, onu kullanmak için bir araca ihtiyacınız olacaktır. Bunun için curl, Postman veya bildiğiniz başka herhangi bir aracı kullanabilirsiniz. Bu kılavuzda Postman’ı kullanıyoruz.
- Lütfen Postman’ı Uygulama üzerinden veya bir web tarayıcısında başlatın. Ardından + simgesini kullanarak yeni bir boş koleksiyon oluşturun ve ardından “İstek ekle” seçeneğine tıklayın. Alternatif olarak, “Yeni” seçeneğine tıklayarak da yeni bir HTTP isteği oluşturabilirsiniz.
- Ayrıca, ConnectedCooking’den aldığınız API İstemci kimlik bilgilerini kullanarak Bearer Token’ı alabilmek için, yeni oluşturduğunuz isteği bir POST isteği olarak düzenlemeniz gerekir.
- Bu nedenle API Belgelerini kontrol etmeniz gerekir Kimlik Doğrulama | ConnectedCooking Yardım Merkezi
- Kılavuzda, sonraki API isteklerinizde kimlik doğrulaması yapmak için bir Bearer Token oluşturmanız gerektiği açıklanmaktadır.
- Bu, bir POST isteği ile gerçekleştirilir. POST isteği şu uç noktayı kullanır: https://app.connectedcooking.com/api/auth/access
- Ayrıca, isteğinizin “Body” sekmesinde Content-Type değerini “x-www-form-urlencoded” olarak ayarlamanız gerekir. Ardından, API İstemcinizden alınan kullanıcı adı, şifre ve kapsam bilgilerinin mevcut sütunlara girilmesi gerekir.
- Sonunda “Gönder” düğmesine tıklayın; artık “accessToken = BearerToken” değerini almanız gerekir.
- Yeni oluşturduğunuz BearerToken’ı kullanmak için herhangi bir API’ye ihtiyacınız vardır.
- Endpoints belgelerinde tüm olası API isteklerini kolayca inceleyebilirsiniz: Uç Noktalar | ConnectedCooking Yardım Merkezi
- Örneğin, cihaz listesi Uç Noktası’nı kullanmayı deneyin.
- Bu istek oldukça basittir; tek yapmanız gereken “https://app.connectedcooking.com” adresini kullanmak, buna “/api/public/devices” kısmını eklemek ve aşağıdaki resimde gösterildiği gibi POST isteğinizdeki “accessToken” değerini Yetkilendirme sekmesine kopyalayıp yapıştırmaktır. Yalnızca "Auth Type" (Oturum Açma Türü) bölümünden "Bearer Token" seçeneğini seçmeniz yeterlidir; ardından "Token" alanı görünecektir.
- Son olarak “Gönder” düğmesine tıklayın; ConnectedCooking hesabınızda kayıtlı tüm cihazlarınızın bir listesini almalısınız (hesabınızda cihaz yoksa bu liste boş olacaktır).
Bu örnek, temel olarak tüm uç noktalara uygulanabilir.
Tebrikler, artık ConnectedCooking ile REST API’lerini kullanabilirsiniz!
Daha fazla bilgiye ihtiyacınız varsa, lütfen ConnectedCooking API Belgelerimize göz atın: Giriş | ConnectedCooking Yardım Merkezi
