
DART Open API Integration Journey (Rails + Flutter)
Notes on integrating the DART Open API (Korea’s Financial Supervisory Service disclosure system) with a Rails backend. Implemented 5 areas: disclosure monitoring, audit opinions, governance, financial indexes, and equity reports – each step came with its own struggles. Implementation Structure Created a model and ActiveJob for each data type. Each job calls the DART API and inserts data using upsert_all – simple structure. DartCorpCodeSyncJob -> dart_companies (company master) DartDisclosureSyncJob -> dart_disclosures (disclosure list) DartMajorEventSyncJob -> dart_major_events (delisting trigger events -- DS001) DartAuditOpinionSyncJob -> dart_audit_opinions (audit opinions -- DS002/DS003) DartGovernanceSyncJob -> dart_executives / dart_major_shareholders (DS004/DS005) DartFinancialIndexSyncJob -> dart_financial_indexes (fnlttSinglAcntAll) DartEquityReportSyncJob -> dart_equity_reports (equity disclosures) Struggle 1: upsert_all + update_only + updated_at Duplication The first error to hit. ...