No-Code-Integrationsentwurf

ISIN-Flow

Method: GET
URL: https://api.isvalid.dev/v0/isin?value={{isin_input}}
Headers:
  Accept: application/json
  User-Agent: [your-app]/1.0
  Authorization: Bearer {{ISVALID_API_KEY}}
Rate Limit: according to your API plan

• Überprüfen Sie das lokale Format vor dem API-Aufruf: genau 12 Zeichen.
• Konfigurieren Sie in der Produktion den API-Schlüssel in der Umgebung (ISVALID_API_KEY).
• Falls gültig, extrahieren Sie Fisin, CFI_Code, Währung, Lei und Figi.
• Bei 429 Fallback und exponentiellen Wiederholungsversuch anwenden.

SWIFT/BIC-Flow

Method: GET
URL: https://api.isvalid.dev/v0/bic?value={{bic_input}}
Headers:
  Accept: application/json
  Authorization: Bearer {{ISVALID_API_KEY}}
Regex BIC: /^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$/

• Ungültiges Format gibt sofortigen Fehler zurück.
• Gültiges Format fragt API ab und bestätigt Institution, Land und Stadt.
• Endgültiger Status: BIC BESTÄTIGT oder BIC NICHT GEFUNDEN.

SBLC/DLC-Fluss

• Es gibt keine vertrauenswürdige kostenlose öffentliche API für die direkte Validierung.
• Führen Sie eine indirekte Validierung durch: Emittenten-BIC plus Liste vertrauenswürdiger Korrespondenzbanken.
• Öffnen Sie die manuelle Aufgabe zur Bestätigung über den offiziellen SWIFT-Kanal (MT799/MT760/MT767).

Vorgeschlagener Datenspeicher

{
  "id": "uuid",
  "tipo_documento": "ISIN|SWIFT|SBLC|DLC",
  "valor_documento": "string",
  "status_validacao": "PENDENTE|VALIDO|INVALIDO|ERRO|MANUAL",
  "data_validacao": "timestamp",
  "fonte_validacao": "isvalid|swiftref|manual",
  "dados_resposta": {"json_original": "{}"},
  "flags": {"alerta_fraude": true, "requer_acao_manual": false}
}

Wiederholung, Sicherheit und Compliance

• Wiederholung: 3 Versuche mit exponentiellem Backoff (1 Sek., 2 Sek., 4 Sek.) für 500/502/503/429.
• Verwenden Sie HTTPS, bereinigen Sie Eingaben und erzwingen Sie eine Ratenbegrenzung nach Benutzer/IP.
• Protokollieren Sie vertrauliche Dokumente nicht im Klartext.
• LGPD/DSGVO: Einwilligung, Aufbewahrungsfrist, Export- und Löschworkflow.