Chaindoc logoChaindoc

Hızlı Başlangıç Kılavuzu

10 dakikadan kısa bir sürede Chaindoc'u kullanmaya başlayın. Bu kılavuz, geliştiriciler için hem web arayüzünü hem de API entegrasyonunu kapsamaktadır.

Son Kullanıcılar İçin

Adım Adım: İlk İmzanız

1Kaydolapp.chaindoc.io adresinde ücretsiz hesabınızı oluşturun. E-posta adresinizi doğrulayın.

2Belgeyi Yükle"Yeni Belge"yi tıklayın ve dosyanızı yükleyin. PDF, Office belgeleri, resimler (50 MB'a kadar) desteklenir.

3Belge Ayrıntılarını EkleBelge adı, açıklaması ve düzenleme için etiketleri girin. Erişim düzeyini seçin (özel, ekip veya genel).

4İmza İsteği Oluştur"İmza İste"yi tıklayın, alıcı e-postalarını ekleyin, son tarihi belirleyin ve mesajı özelleştirin.

5İmza Akışını Yapılandırınİmza sırasını seçin (paralel veya sıralı), gerekirse KYC'yi etkinleştirin, bildirim tercihlerini seçin.

6İstek Gönderİnceleme ve gönderme. Alıcılar, güvenli imza bağlantısı içeren bir e-posta alırlar.

7İlerlemeyi Takip Edinİmza durumunu gerçek zamanlı olarak izleyin. İmzalar toplandığında bildirim alın.

8İmzalı Belgeyi İndirİşlem tamamlandığında, blok zinciri sertifikası ile imzalanmış belgeyi indirin.

Geliştiriciler için

REST API ve SDK'larımızı kullanarak Chaindoc'u uygulamanıza entegre edin.

1. API Anahtarlarını Alın

2. SDK'yı yükleyin

Kullanım durumunuza göre SDK'yı seçin:

# Node.js 18+ required
npm install @chaindoc_io/server-sdk

3. API aracılığıyla İlk Belgenizi Oluşturun

server.ts
import { Chaindoc } from '@chaindoc_io/server-sdk';
import { readFile } from 'fs/promises';

// Initialize SDK
const chaindoc = new Chaindoc({
  secretKey: process.env.CHAINDOC_SECRET_KEY!,
});

// 1. Upload document
const buffer = await readFile('./contract.pdf');
const file = new Blob([buffer], { type: 'application/pdf' });
const { media } = await chaindoc.media.upload([file]);

// 2. Create document record
const doc = await chaindoc.documents.create({
  name: 'Service Agreement',
  description: 'Q4 2024 Contract',
  media: media[0],
  status: 'published', // Triggers blockchain verification
  hashtags: ['#contract', '#2024'],
  meta: [{ key: 'client', value: 'Acme Corp' }],
});

console.log('Document created:', doc.documentId);

4. İmza İsteği Oluşturun

server.ts
// Create signature request for multiple signers
const sigRequest = await chaindoc.signatures.createRequest({
  versionId: doc.document.versions[0].uuid,
  recipients: [
    { email: 'signer1@example.com' },
    { email: 'signer2@example.com' },
  ],
  deadline: new Date('2024-12-31'),
  message: 'Please review and sign this agreement',
  embeddedFlow: true, // Enable for frontend integration
});

console.log('Signature request created:', sigRequest.signatureRequest.uuid);

5. İmza Arayüzünü (Ön Uç) Entegre Edin

Web uygulamanızda gömülü imza için:

// Create embedded session for signer
const session = await chaindoc.embedded.createSession({
  email: 'signer1@example.com',
  metadata: {
    documentId: doc.documentId,
    signatureRequestId: sigRequest.signatureRequest.uuid,
  },
});

// Return sessionId to frontend
res.json({ sessionId: session.sessionId });

6. Durumu Takip Edin ve Olayları Yönet

terminal
// Check signature request status
const status = await chaindoc.signatures.getRequestStatus(
  sigRequest.signatureRequest.uuid
);

if (status.signatureRequest.status === 'completed') {
  console.log('All signatures collected!');
  // Download signed document
  // Send notifications
  // Update your database
}

7. Webhook'ları Ayarlama (İsteğe Bağlı)

Etkinlikler için gerçek zamanlı bildirimler alın:

webhooks.ts
// Configure webhook endpoint
app.post('/webhooks/chaindoc', (req, res) => {
  const event = req.headers['x-webhook-event'];
  const payload = req.body;
  
  switch (event) {
    case 'document.verified':
      console.log('Document verified on blockchain:', payload.txHash);
      break;
    case 'signature.request.completed':
      console.log('All signatures collected!');
      // Send notifications, update status, etc.
      break;
  }
  
  res.status(200).send('OK');
});

Tam İş Akışı Örneği

İşte tüm adımları birleştiren eksiksiz bir uçtan uca örnek:

complete-workflow.ts
import { Chaindoc } from '@chaindoc_io/server-sdk';
import { readFile } from 'fs/promises';

async function createSigningWorkflow() {
  const chaindoc = new Chaindoc({
    secretKey: process.env.CHAINDOC_SECRET_KEY!,
  });
  
  // Step 1: Upload document
  const buffer = await readFile('./contract.pdf');
  const file = new Blob([buffer], { type: 'application/pdf' });
  const { media } = await chaindoc.media.upload([file]);
  
  // Step 2: Create document
  const doc = await chaindoc.documents.create({
    name: 'Service Agreement',
    description: 'Contract for consulting services',
    media: media[0],
    status: 'published',
    hashtags: ['#contract'],
    meta: [],
  });
  
  // Step 3: Create signature request
  const sigRequest = await chaindoc.signatures.createRequest({
    versionId: doc.document.versions[0].uuid,
    recipients: [{ email: 'signer@example.com' }],
    deadline: new Date('2024-12-31'),
    embeddedFlow: true,
  });
  
  // Step 4: Create session for frontend
  const session = await chaindoc.embedded.createSession({
    email: 'signer@example.com',
    metadata: {
      documentId: doc.documentId,
      signatureRequestId: sigRequest.signatureRequest.uuid,
    },
  });
  
  return {
    documentId: doc.documentId,
    sessionId: session.sessionId,
  };
}

// Usage
const { documentId, sessionId } = await createSigningWorkflow();
console.log('Ready for signing:', { documentId, sessionId });

Sonraki Adımlar

  • Ayrıntılı SDK kurulumu için Kurulum kılavuzunu okuyun.
  • Tam uç nokta referansı için API Belgelerini inceleyin.
  • Çerçeveye özgü örnekler için SDK belgelerini kontrol edin (React, Vue, Angular)
  • Gerçek zamanlı olay bildirimleri için Webhooks'ları ayarlayın
  • Üretim dağıtımı için Güvenlik En İyi Uygulamalarını inceleyin.

Sık Sorulan Sorular

Blockchain doğrulaması ne kadar sürer?

Blockchain doğrulaması, ağa bağlı olarak genellikle 1-5 dakika içinde tamamlanır. Belgeler hemen kullanılabilir, doğrulama eşzamansız olarak gerçekleşir.

Ücretli bir plan olmadan test edebilir miyim?

Evet! Ücretsiz plan web arayüzü erişimini içerir. API erişimi için İş planı gerekir, ancak test için sandbox ortamını kullanabilirsiniz.

İmzalar yasal olarak bağlayıcı mıdır?

Evet, Chaindoc imzaları eIDAS, ESIGN Act ve UETA düzenlemelerine uygundur. Blockchain doğrulama, ek yasal kanıt sağlar.

Hangi dosya formatları desteklenir?

PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT, JPG, PNG, GIF, WEBP, SVG, MP4, AVI, MOV, WMV. Maksimum dosya boyutu: 50 MB.