Python, Node.js ve PHP ile Biyometrik Geri Çağırma Alıcısı Oluşturma
Geri çağırma alıcısı, her parmak izi, yüz veya kart taramasını kendi sisteminizde bir kayda dönüştüren küçük kod parçasıdır. Cams Biometrics Gateway, doğrulanmış her taramayı bir JSON isteği olarak sunucunuza gönderir ve sunucunuz alındığını onaylamak için yanıt verir. Bu alıcıyı sıfırdan yazmanız gerekmez. Cams, Python, Node.js ve PHP için AI Code Generator Prompts sunar: bunlardan birini Claude veya ChatGPT gibi bir yapay zeka asistanına yapıştırdığınızda, bir geri çağırma alıcısı, bir REST istemcisi ve bir test arayüzü içeren eksiksiz, çalışan bir dosya elde edersiniz. Bu eğitim, bir alıcının neler yapması gerektiğini, dilinize uygun bir tane nasıl oluşturacağınızı, nasıl yapılandıracağınızı ve canlıya geçmeden önce nasıl test edeceğinizi açıklar.
01 · Altı Görev
Bir Geri Çağırma Alıcısının Yapması Gerekenler
Hangi dili kullanırsanız kullanın, her biyometrik geri çağırma alıcısı aynı altı görevi yerine getirir. Bunlar, oluşturduğunuz herhangi bir kodda kontrol etmeniz gereken noktalardır.
| Görev | Anlamı | Neden önemli |
|---|---|---|
| 1. İsteği kabul edin | Ham JSON gövdesi içeren bir HTTP/HTTPS POST isteği alın | Gateway her olayı bu şekilde iletir |
| 2. Belirteci doğrulayın | AuthToken değerini beklenen geri çağırma belirtecinizle karşılaştırın | Başkalarının URL adresinize sahte yoklama göndermesini engeller |
| 3. Olay türüne göre yönlendirin | RealTime içindeki anahtara bakın ve buna göre işlem yapın | Her geri çağırma bir yoklama kaydı değildir; bazıları fotoğraf veya kullanıcı değişikliklerini bildirir |
| 4. Yinelenenleri atlayın | Zaten kaydettiğiniz olayları yok saymak için OperationID kullanın | Tekrarlanan bir teslimat asla çift kayda dönüşmez |
| 5. Kaydedin ve günlüğe yazın | İhtiyacınız olan alanları kaydedin ve her geri çağırmayı günlüğe yazın | HRMS, bordro veya panonuzun kullanacağı kaydı oluşturur |
| 6. Tamamlandı yanıtı verin | HTTP 200 ile {“status”:”done”} döndürün | Gateway'e olayın güvenle ulaştığını bildirir |
02 · Verilerinizi Tanıyın
Alacağınız Veri Yükü
En yaygın geri çağırma, biri her taradığında gönderilen bir yoklama kaydıdır. Bu örneği sample.json olarak kaydedin, çünkü alıcınızı daha sonra test etmek için kullanacaksınız.
|
Callback API, alıcınıza gönderilen PunchLog isteği {
"RealTime": {
"OperationID": "9nu1wak5616p",
"LabelName": "Burj Khalifa",
"SerialNumber": "ZHM11xxxxxxxx",
"PunchLog": {
"Type": "CheckOut",
"Temperature": "36.8",
"FaceMask": false,
"InputType": "Fingerprint",
"UserId": "2",
"LogTime": "2020-09-17 07:48:22 GMT +0530"
},
"AuthToken": "COJJ7eiIPBGUfmIQPvh2PJWWDLX7OuKs",
"Time": "2020-09-17 04:19:03 GMT +0000"
}
}
|
Herhangi bir geri çağırmayı işledikten sonra alıcınız HTTP 200 ile tam olarak bu gövdeyi döndürmelidir:
|
Callback API, alıcınızın döndürmesi gereken yanıt { "status": "done" } (HTTP 200)
|
Geri çağırma olay türleri
Her geri çağırma bir RealTime nesnesinin içinde gelir. Alıcınız, aşağıdaki anahtarlardan hangisinin mevcut olduğunu kontrol ederek ne yapacağına karar verir:
| RealTime içindeki anahtar | Bildirdiği bilgi |
|---|---|
| PunchLog | Bir devam taraması: kim, giriş veya çıkış, ne zaman ve hangi yöntemle |
| UserUpdated | Bir kullanıcının bilgileri cihazda güncellendi |
Geliştiricileri yanıltabilecek iki ayrıntı
| Ayrıntı | Dikkat edilecekler |
|---|---|
| Yanıt anahtarı küçük harflidir | status anahtarını küçük harfle, done değeriyle döndürün. RESTful API yanıtlarındaki büyük harfle başlayan Status alanını kopyalamayın |
| LogTime biçimi | LogTime şöyle görünür: 2020-09-17 07:48:22 GMT +0530. Cihazın saat dilimi farkıyla birlikte gerçek tarama zamanıdır. Zamanı farkıyla birlikte ayrıştırın ve yoklama zamanı olarak kullanın |
03 · Kodu Yapay Zekâ Yazsın
Alıcınızı AI Code Generator Prompts ile Oluşturun
Cams, desteklenen her sunucu dili için hazır bir prompt dosyası yayınlar. Her prompt, Cams Web API 3.0 spesifikasyonunun bir özetini ve neyin oluşturulacağına dair net talimatları içerir. Promptu bir yapay zekâ asistanına yapıştırırsınız ve asistan, kullandığınız yığın için eksiksiz, tek dosyalık bir uygulama üretir.
|
Prompt dosyasını indirin Sonraki bölümde dilinizi seçin ve .txt prompt dosyasını indirin. |
|
|
Bir yapay zekâ asistanına yapıştırın Claude, ChatGPT, Copilot veya herhangi bir yapay zekâ kodlama aracını açın ve prompt içeriğinin tamamını yapıştırın. |
|
|
Çalışan eksiksiz bir dosya alın Yapay zekâ tek bir dosya üretir. Yapılandırma değerlerinizi girin, dosyayı yayınlayın ve çalıştırın. |
| Oluşturulan her dosya şunları içerir | Ne yapar |
|---|---|
| Geri çağırma alıcısı | Ham POST gövdesini okur, AuthToken değerini doğrular, olay türüne göre yönlendirir, her geri çağırmayı günlüğe yazar, yoklama kayıtlarını saklar, devam fotoğraflarını kaydeder ve done yanıtı verir |
| REST istemcisi | Genel bir istek fonksiyonu ve AddUser, DeleteUser, ResendAllUser ve UpdateAccessTime gibi 27 RESTful işlemin tamamı için sarmalayıcı fonksiyonlar |
| HTML test arayüzü | Yapılandırma alanlarınızın, bir işlem açılır listesinin, istek şablonlarıyla önceden doldurulmuş bir JSON düzenleyicisinin, bir yanıt görüntüleyicinin ve son geri çağırmaların listesinin yer aldığı bir tarayıcı sayfası |
|
Önce barındırılan dokümantasyon gelir Her prompt, yapay zekâya tam Cams Web API dokümantasyonunu okumasını ve işlemler, JSON şemaları, alan adları ve yanıt kodları için yetkili kaynak olarak kullanmasını söyler. Prompt özetindeki herhangi bir bilgi barındırılan dokümantasyonla çelişirse, dokümantasyon esas alınır. |
04 · Dilinizi Seçin
Python, Node.js ve PHP için Promptlar
Her prompt, kendi dili için minimum bağımlılıkla deyimsel kod üretecek şekilde ayarlanmıştır.
|
|
|
Promptlar ayrıca Minimal API ile C# (.NET 8), yerleşik HttpServer ve hiçbir bağımlılık olmadan Java, yalnızca net/http ve standart kütüphane ile Go ve Sinatra ile SQLite kullanan Ruby için de mevcuttur. Hepsini Cams Web API dokümantasyonunun AI Code Generator Prompts bölümünde bulabilirsiniz. Promptları al.
05 · Ayarlanacak Üç Değer
Oluşturulan Dosyayı Yapılandırma
Oluşturulan dosyanın en üstünde bir yapılandırma bloğu bulunur. PHP sürümünde bu blok şöyle görünür; diğer diller de aynı üç değeri kullanır:
|
Yapılandırma bloğu, PHP sürümü $CONFIG = [
'base_url' => 'https://YOUR_RESTFUL_ENDPOINT_URL',
'stgid' => 'YOUR_SERVICE_TAG_ID',
'auth_token' => 'YOUR_AUTH_TOKEN',
];
|
| Ayar | Ne girilmeli |
|---|---|
| base_url | Cams API Monitor hesabınızdaki RESTful uç nokta URL adresi |
| stgid | Service Tag ID değeriniz. |
| auth_token | Giden RESTful isteklerinize eklenen ve gelen geri çağırma isteklerindeki AuthToken ile karşılaştırılan AuthToken değeriniz. |
|
Belirteçleri ortak koddan uzak tutun Hızlı bir test için değerleri yapılandırma bloğuna yazmak sorun değildir. Canlıya geçmeden önce belirteçleri ortam değişkenlerine veya bir gizli bilgi yöneticisine taşıyın; böylece asla sürüm kontrolüne veya paylaşılan bir dosyaya girmezler. |
Yapılandırıp herkese açık bir HTTPS adresinde yayınladığınızda, bu adresi Cams Gateway içinde Callback URL olarak ayarlayın. Bundan sonra doğrulanmış her tarama gerçek zamanlı olarak alıcınıza ulaşır.
06 · Cihazları Bağlamadan Önce Test Edin
Alıcınızı Test Etme
Geri çağırma alıcısını test etmek için biyometrik cihaza ihtiyacınız yoktur. Eşleşen bir geri çağırma belirteci kullanarak örnek veriyi cURL ile kendiniz gönderin ve yanıtı kontrol edin.
|
Terminal, test geri çağırması gönderin # Save the sample payload as sample.json, then send it to your receiver:
curl -X POST https://YOUR_SERVER/YOUR_CALLBACK_PATH \
-H "Content-Type: application/json" \
-d @sample.json
# Expected response (HTTP 200):
# {"status":"done"}
|
| Test | Ne gönderilmeli | Beklenen sonuç |
|---|---|---|
| Geçerli olay | AuthToken değeri auth_token değerinize ayarlı sample.json | done ile HTTP 200 ve yoklama kaydedilir |
| Yinelenen olay | Aynı istek ikinci kez | done ile HTTP 200 ve ikinci bir kayıt kaydedilmez |
| Yanlış belirteç | Farklı bir AuthToken içeren sample.json | Reddedilir ve hiçbir şey kaydedilmez |
| Giriş olayı | Type değeri CheckIn olarak değiştirilmiş sample.json | Giriş olarak kaydedilir |
| RESTful işlemi | Bir işlem göndermek için yerleşik HTML test arayüzünü kullanın | Status ve StatusCode içeren bir yanıt |
Oluşturulan HTML test arayüzü, RESTful tarafını denemeyi kolaylaştırır: dosyayı bir tarayıcıda açın, açılır listeden bir işlem seçin, önceden doldurulmuş JSON'ı düzenleyin ve gönderin. Aynı sayfadaki son geri çağırmalar görüntüleyicisi, test geri çağırmalarınızın alındığını doğrular.
07 · Üretim Kontrol Listesi
Canlıya Geçmeden Önce Gözden Geçirin
Yapay zekâ tarafından üretilen kod hızlı ve güvenilir bir başlangıç noktasıdır; ancak her kod gibi, gerçek çalışan verilerini işlemeden önce gözden geçirilmelidir.
| Madde | Tamamlanma koşulu |
|---|---|
| Kod gözden geçirildi | Bir geliştirici oluşturulan dosyayı okumuş ve her bölümün ne yaptığını anlamıştır |
| Yalnızca HTTPS | Alıcıya yalnızca geçerli sertifikası olan HTTPS üzerinden erişilebilir |
| Belirteçler korunuyor | AuthToken değerleri ortam değişkenlerinde veya bir gizli bilgi yöneticisinde saklanıyor |
| Yinelenenler yönetiliyor | OperationID kaydediliyor ve kontrol ediliyor, böylece tekrarlanan teslimatlar yok sayılıyor |
| Depolama uygun | JSON dosya deposu küçük kurulumlar için uygundur; daha büyük dağıtımlar üretim veritabanına geçebilir |
| Test arayüzü korunuyor | HTML test sayfası parola korumalıdır veya herkese açık sunucularda devre dışıdır |
| Fotoğraflar dikkatle işleniyor | Diske kaydedilen devam fotoğraflarına erişim denetlenir ve yalnızca gerektiği kadar süreyle saklanır |
| İzleme mevcut | Hatalar ve olağandışı geri çağırma hacimleri kaydedilir ve kendi izleme sisteminizle uyarı üretilir |
|
İş kurallarını başka yerde tutun Alıcının görevi kabul etmek, doğrulamak, yönlendirmek, kaydetmek ve onaylamaktır. Kimin geç kaldığına karar vermek, fazla mesaiyi hesaplamak veya bildirim göndermek, HRMS, ERP veya otomasyon araçları gibi kayıtlı olayları okuyan sistemlere aittir. Odaklanmış bir alıcının güvenliğini sağlamak ve bakımını yapmak daha kolaydır. |
Sık Sorulan Sorular
|
Kendim kod yazmam gerekiyor mu? Genellikle hayır. AI Code Generator Prompts, eksiksiz çalışan bir dosya üretir. Üç yapılandırma değeri ayarlarsınız, dosyayı yayınlarsınız ve test edersiniz. Yine de canlıya geçmeden önce bir geliştirici kodu gözden geçirmelidir. |
|
Hangi yapay zekâ asistanları promptlarla çalışır? Claude, ChatGPT ve Copilot dahil, yetkin herhangi bir yapay zekâ kodlama asistanı. Asistanın tam spesifikasyona sahip olması için prompt içeriğinin tamamını tek seferde yapıştırın. |
|
RESTful uç nokta URL adresini ve Service Tag ID değerini nerede bulurum? İkisi de Cams API Monitor hesabınızdan alınır. RESTful istekleri, uç nokta URL adresine ?stgid= ve ardından Service Tag ID değerinizle gönderilir. |
|
Yinelenen bir olay için neden done ile yanıt veriyorum? Olay güvenle ulaştığı için, daha önce kaydetmiş olsanız bile. done ile yanıt vermek, Gateway'e olayı tekrar göndermesine gerek olmadığını bildirir. |
|
Listede olmayan bir dili kullanabilir miyim? Evet. Geri çağırma alıcısının yalnızca bir HTTPS POST isteğini kabul edip JSON döndürmesi gerekir. Promptlar bir kısayoldur ve aynı API, bunu yapabilen herhangi bir dille çalışır. |
Sonuç: Bir Öğleden Sonrada Promptan Gerçek Zamanlı Devam Kaydına
Biyometrik bir geri çağırma alıcısı küçüktür, ancak doğrulanmış her taramayı HRMS, bordro, paneller ve otomasyonlar için canlı verilere dönüştüren parçadır. Cams AI Code Generator Prompts ile onu boş bir sayfadan oluşturmanız gerekmez. Python, Node.js veya PHP için promptu indirin, yapay zekâ asistanınıza yapıştırın, üç değeri ayarlayın ve test edin. Ardından gözden geçirin, güvenli hale getirin ve gerçek zamanlı devam verilerinin akmaya başlamasını sağlayın.
Cams Biometrics Gateway, alıcınızın ihtiyaç duyduğu olayları iletir. Callback API'si, 15'ten fazla markadan gelen cihazlardan doğrulanmış her taramayı gerçek zamanlı olarak, tek ve tutarlı bir JSON biçiminde gönderir; RESTful API ise oluşturduğunuz istemcinizin çağırabileceği 27 işlem sunar. Tüm iletişim, kimlik doğrulama belirteci kontrolü ve isteğe bağlı AES-256 şifrelemesiyle HTTP/HTTPS üzerinden gerçekleşir. Platformu CamsBiometrics.com adresinde inceleyin ve her AI Code Generator Prompt dahil tam Web API dokümantasyonunu okuyun: Promptları al.