Integration

Integrationsleitfaden für anolink-Produkte in Ihre Systemlandschaft

Integrationsübersicht

Die anolink-Plattform bietet verschiedene Integrationsmöglichkeiten, abhängig von Ihrem Use Case und der gewählten Architektur.

Integrationsvarianten

API-Integration

Vollständige Kontrolle durch direkte Nutzung der REST-APIs. Ideal für individualisierte Workflows und tiefe Integration in bestehende Systeme.

Vorteile:

Maximale Flexibilität
Vollständige Anpassbarkeit
Eigene UX-Gestaltung

Portal-Integration

Nutzung der fertigen anolink SEND Portale mit minimalem Integrationsaufwand. Ideal für schnellen Einstieg und standardisierte Prozesse.

Vorteile:

Schnelle Implementierung
Bewährte UX
Minimaler Wartungsaufwand

Typischer Integrationsablauf

Anforderungsanalyse: Definieren Sie Ihre Use Cases und Anforderungen. Welche Prozesse sollen digitalisiert werden? Welche Systeme müssen angebunden werden?
Architektur-Design: Planen Sie die technische Integration. Welche APIs werden benötigt? Wie sieht der Datenfluss aus? Welche Authentifizierung wird verwendet?
Sandbox-Setup: Richten Sie Ihre Sandbox-Umgebung ein und führen Sie erste Tests durch. Umgebung einrichten
Implementierung: Entwickeln Sie die Integration basierend auf der API-Dokumentation. Nutzen Sie unsere Code-Beispiele als Startpunkt.
Testing: Testen Sie alle Szenarien gründlich in der Sandbox-Umgebung. Berücksichtigen Sie auch Fehlerszenarien und Edge Cases.
Go-Live: Nach erfolgreichen Tests erfolgt die Freischaltung der Produktionsumgebung und der produktive Betrieb kann starten.

API-Integration: anolink Sign

Die Integration von anolink Sign erfolgt über mehrere API-Endpunkte:

Dokumenten-Management

// Dokument mit Signaturfeldern anlegen
// POST /api/documents
 
{
  "name": "Arbeitsvertrag_MusterGmbH",
  "template_pdf": "base64_encoded_pdf",
  "signature_fields": [
    {
      "page": 1,
      "x": 100,
      "y": 200,
      "width": 200,
      "height": 50,
      "role": "employee"
    }
  ]
}

Signatur-Anfragen erstellen

// Signaturauftrag erstellen
// POST /api/signature-requests
 
{
  "document_id": "doc_123abc",
  "signers": [
    {
      "identifier": "employee_001",
      "email": "mitarbeiter@example.com",
      "role": "employee"
    }
  ]
}

// Response enthält signing_link
 
{
  "signature_id": "sig_456def",
  "signing_link": "https://sign.anolink.de/sign/sig_456def"
}

Status-Abfrage

// GET /api/signature-requests/{signature_id}
 
{
  "status": "completed",
  "signed_at": "2025-10-10T14:30:00Z",
  "signed_document_url": "https://..."
}

Die vollständige API-Dokumentation für anolink Sign finden Sie unter anolink API.

Webhooks

Nutzen Sie Webhooks, um über Statusänderungen informiert zu werden:

// Webhook-Konfiguration
// POST /api/webhooks
 
{
  "url": "https://your-system.com/webhooks/anolink",
  "events": ["signature.completed", "signature.declined"]
}

// Ihr Webhook-Endpoint erhält:
 
{
  "event": "signature.completed",
  "signature_id": "sig_456def",
  "timestamp": "2025-10-10T14:30:00Z",
  "data": {
    "status": "completed",
    "signed_document_url": "https://..."
  }
}

Best Practices

Fehlerbehandlung

Implementieren Sie robuste Fehlerbehandlung und Retry-Logik für API-Aufrufe. Nutzen Sie die HTTP-Statuscodes zur Fehlerklassifizierung.

Sicherheit

Speichern Sie API-Tokens sicher (z.B. in Environment Variables oder Secrets Management). Verwenden Sie HTTPS für alle Kommunikation.

Monitoring

Implementieren Sie Monitoring und Logging für alle API-Interaktionen. Nutzen Sie Webhooks für zeitnahe Benachrichtigungen.

Rate Limiting

Beachten Sie die API-Rate-Limits und implementieren Sie entsprechende Throttling-Mechanismen. Bei höherem Bedarf sprechen Sie uns an.

Code-Beispiele

Node.js / JavaScript

const axios = require('axios');
 
const ANOLINK_API = 'https://api.anolink.de/v1';
const API_TOKEN = process.env.ANOLINK_API_TOKEN;
 
async function createSignatureRequest(documentId, signers) {
  try {
    const response = await axios.post(
      `${ANOLINK_API}/signature-requests`,
      {
        document_id: documentId,
        signers: signers
      },
      {
        headers: {
          'Authorization': `Bearer ${API_TOKEN}`,
          'Content-Type': 'application/json'
        }
      }
    );
 
    return response.data;
  } catch (error) {
    console.error('Error creating signature request:', error);
    throw error;
  }
}

Python

import requests
import os
 
ANOLINK_API = 'https://api.anolink.de/v1'
API_TOKEN = os.environ.get('ANOLINK_API_TOKEN')
 
def create_signature_request(document_id, signers):
    headers = {
        'Authorization': f'Bearer {API_TOKEN}',
        'Content-Type': 'application/json'
    }
 
    payload = {
        'document_id': document_id,
        'signers': signers
    }
 
    response = requests.post(
        f'{ANOLINK_API}/signature-requests',
        json=payload,
        headers=headers
    )
 
    response.raise_for_status()
    return response.json()

Support & Hilfe

Bei Fragen zur Integration:

API-Dokumentation – Vollständige API-Referenz mit allen Endpunkten
E-Mail Support – Technischer Support per E-Mail: fabian@anonetics.de

Implementierung Produkte