NFTPAYROLL Servis API'si
Bordro verilerini platforma aktarmanız ve her bordroyu doğrulanabilir bir NFT olarak mint etmeniz için sunucudan-sunucuya bir API. Tek bir API anahtarıyla kimlik doğrulayın, kayıtlarınızı gönderin ve her mint'i zincir üstü işlemine kadar takip edin.
Üç adımda yayında
Sıfırdan ilk mint edilen bordronuza.
API anahtarınızı alın
Şirket yöneticiniz panelden bir servis API anahtarı oluşturur. Her anahtar tek bir şirkete bağlıdır.
Bordroları gönderin
Kayıtlarınızı X-API-Key header'ı ile /payrolls/bulk adresine POST edin. Çalışanlar otomatik eşleştirilir veya oluşturulur.
Mint'i takip edin
/payrolls/batches/{ref} adresini sorgulayarak her kaydın pending durumundan sent durumuna geçişini izleyin.
Tek anahtar, her istek
Servis API anahtarınızı X-API-Key header'ında gönderin. Anahtar, tüm kayıtların oluşturulacağı şirketi (tenant) belirler.
Authorization: Bearer <key> formatı da kabul edilir. Anahtarlar saklanırken hash'lenir; istediğiniz zaman rotasyona alınabilir veya iptal edilebilir.İki aktarım yöntemi
Hız için direkt aktarım, doğrulama kapısı için review → submit seçin.
Direkt aktarım
Kayıtlar tek çağrıda doğrulanır, oluşturulur ve mint kuyruğuna alınır.
- Tek istek, anında mint
- Kayıt bazlı başarı / hata sonuçları
- Güvenilir, önceden doğrulanmış veri için ideal
Review → Submit
Önce doğrulanmış batch'i önizleyin, sonra submit ile kalıcı hale getirip mint edin.
-
ready/duplicate/faileddurumlarını inceleyin - Onay kapılı ve yüksek hacme uygun
- Submit edene kadar hiçbir şey oluşturulmaz
API'yi keşfedin
Altı endpoint tüm yaşam döngüsünü kapsar. Canlı istek göndermek için herhangi birini interaktif referansta açın.
Bordroları toplu aktarPOST
POST /payrolls/bulkBir bordro listesini doğrula, oluştur ve anında NFT mint kuyruğuna al.
Batch durumunu sorgulaGET
GET /payrolls/batches/{ref}Batch'teki her kaydın mint durumunu, tx hash, token id ve IPFS CID değerlerini izle.
Review batch oluşturPOST
POST /payrolls/review-batchesKayıtları henüz oluşturmadan doğrula ve önizle.
Review batch'leri listeleGET
GET /payrolls/review-batchesSon 100 review batch'ini özet sayımlarıyla döndür.
Review batch detayıGET
GET /payrolls/review-batches/{id}Submit'ten önce review batch'indeki her kaydı incele.
Review batch'i submit etPOST
POST /payrolls/review-batches/{id}/submitGözden geçirilmiş batch'i bordrolara dönüştür ve mint kuyruğuna al.
Rate limit
Varsayılan limit anahtar başına dakikada 60 istektir. Aşıldığında 429 Too Many Requests döner. Yüksek hacimli entegrasyonlar için limit yükseltmek üzere bizimle iletişime geçin.
Hata yönetimi
401 geçersiz anahtar · 404 bulunamadı · 409 zaten submit edilmiş · 422 doğrulama · 429 rate limit. Hatalar JSON message döner.