Rangka Tindakan Penyepaduan Tanpa Kod

Aliran ISIN

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

• Sahkan format setempat sebelum panggilan API: tepat 12 aksara.
• Dalam pengeluaran, konfigurasikan kunci API dalam persekitaran (ISVALID_API_KEY).
• Jika sah, ekstrak fisin, cfi_code, mata wang, lei dan figi.
• Jika 429, gunakan sandaran dan percubaan semula eksponen.

Aliran SWIFT/BIC

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})?$/

• Format tidak sah mengembalikan ralat serta-merta.
• API pertanyaan format yang sah dan mengesahkan institusi, negara dan bandar.
• Status akhir: BIC DISAHKAN atau BIC TIDAK DITEMUI.

Aliran SBLC / DLC

• Tiada API awam percuma yang dipercayai untuk pengesahan langsung.
• Lakukan pengesahan tidak langsung: penerbit BIC serta senarai bank koresponden yang dipercayai.
• Buka tugas manual untuk pengesahan melalui saluran SWIFT rasmi (MT799/MT760/MT767).

Simpanan Data yang Dicadangkan

{
  "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}
}

Cuba semula, Keselamatan dan Pematuhan

• Cuba semula: 3 percubaan dengan mundur eksponen (1s, 2s, 4s) untuk 500/502/503/429.
• Gunakan HTTPS, bersihkan input dan kuatkuasakan had kadar oleh pengguna/IP.
• Jangan log dokumen sensitif dalam teks biasa.
• LGPD/GDPR: persetujuan, tempoh pengekalan, aliran kerja eksport dan pemadaman.