OPENDART api를 이용한 공시정보 가져오기

OPENDART의 api를 이용해 공시정보를 가져오는 코드를 작성했다. api 사용을 위해서는 먼저 https://opendart.fss.or.kr/ 에서 회원가입 후 인증키를 발급받아야 한다. 또한 공시대상회사의 고유번호를 알아야 한다. 공시정보와 고유번호 확인 가이드 문서는 아래의 링크를 방문하면 된다.

• 공시정보 : https://opendart.fss.or.kr/guide/detail.do?apiGrpCd=DS001&apiId=2019001
• 고유번호 : https://opendart.fss.or.kr/guide/detail.do?apiGrpCd=DS001&apiId=2019018

PHP로 작성된 코드는 아래와 같다.

<?php
function setCacheFile($fileName, $valName, $target)
{
    $dir = dirname($fileName);

    if (!is_dir($dir) || !is_writable($dir)) {
        return false;
    }

    // Serializing Targeted Data
    $target = base64_encode(serialize($target));

    // Writing to Cache File
    $fp = fopen($fileName, 'w+');
    fwrite($fp, '<?php ');
    fwrite($fp, '$' . $valName . ' = unserialize(base64_decode("' . $target . '"));');

    fclose($fp);

    return true;
}

function getOpenDartDisclosureInfo($page, $rows)
{
    $parms = array(
        'crtfc_key'  => DART_API_KEY,
        'corp_code'  => DART_CORP_CODE,
        'bgn_de'     => preg_replace('#[^\d]#', '', DART_DISCLOSURE_BGN_DE),
        'end_de'     => preg_replace('#[^\d]#', '', G5_TIME_YMD),
        'page_no'    => $page,
        'page_count' => $rows
    );

    $headers = [
        'Accept: ' . $_SERVER['HTTP_ACCEPT'],
        'Accept-Encoding: gzip, deflate',
        'Accept-Language: ' . $_SERVER['HTTP_ACCEPT_LANGUAGE'],
        'Cache-Control: no-cache',
        'User-Agent: ' . $_SERVER['HTTP_USER_AGENT']
    ];

    $url = 'https://opendart.fss.or.kr/api/list.json?'.http_build_query($parms);

    $ch = curl_init();

    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

    $return = curl_exec($ch);

    if (curl_errno($ch)) {
        return 'Curl error: '.curl_errno($ch);
    }

    curl_close($ch);

    $return = trim($return);

    $json = json_decode($return);

    if (!$json) {
        return 'JSON error';
    }

    if ($json->status != '000') {
        return 'Error : '.$json->message . '(' . $json->status . ')';
    }

    $data = array();
    $list = array();

    $data['total'] = $json->total_count;
    $data['pages'] = $json->total_page;

    foreach ($json->list as $v) {
        $info = array();

        $info['no']     = $v->rcept_no;
        $info['title']  = $v->report_nm;
        $info['date']   = preg_replace('#^([\d]{4})([\d]{2})([\d]{2})$#', '\\1-\\2-\\3', $v->rcept_dt);
        $info['submit'] = $v->flr_nm;
        $info['href']   = 'http://dart.fss.or.kr/dsaf001/main.do?rcpNo='.$v->rcept_no;
        $info['mhref']  = 'http://m.dart.fss.or.kr/html_mdart/MD1007.html?rcpNo='.$v->rcept_no;

        $list[] = $info;
    }

    $data['list'] = $list;

    return $data;
}

function getDisclosureInfo($page = 1, $rows = 10)
{
    // cache 처리
    $result = false;
    $cache = G5_DATA_PATH.'/cache/disclosureInfo.php';

    $refresh = false;

    if (is_file($cache)) {
        require_once($cache);

        $data1 = $data;
    } else {
        $refresh = true;
    }

    $data2 = getOpenDartDisclosureInfo(1, $rows);

    $data = [];
    $list = [];

    if (is_array($data2) && !empty($data2)) {
        if (isset($data1['total']) && isset($data2['total']) && $data1['total'] != $data2['total']) {
            $refresh = true;
        }

        $list = array_merge($list, $data2['list']);

        if ($refresh && $data2['pages'] > 1) {
            for ($i = 2; $i <= $data2['pages']; $i++) {
                $info = getOpenDartDisclosureInfo($i, $rows);

                if (is_array($info) && !empty($info)) {
                    $list = array_merge($list, $info['list']);
                }
            }
        }

        $data = $data2;

        $data['list'] = $list;
    }

    if ($refresh) {
        $result = setCacheFile($cache, 'data', $data);

        if ($result) {
            require_once($cache);
        }
    } else {
        $data = $data1;
    }

    $start = ($page - 1) * $rows;

    return ['total' => $data['total'], 'pages' => $data['pages'], 'list' => array_slice($data['list'], $start, $rows)];
}

요청 파라미터 중 bgn_de 의 값은 최소 회사의 상장일 이전으로 설정해야 할 것으로 생각된다. 위 코드로 얻어진 결과는 아래와 같다.

Array
(
    [total] => 12
    [pages] => 2
    [list] => Array
        (
            [0] => Array
                (
                    [no] => 20201216900543
                    [title] => 주식명의개서정지(주주명부폐쇄)
                    [date] => 2020-12-16
                    [submit] => 앱코
                    [href] => http://dart.fss.or.kr/dsaf001/main.do?rcpNo=20201216900543
                    [mhref] => http://m.dart.fss.or.kr/html_mdart/MD1007.html?rcpNo=20201216900543
                )

            [1] => Array
                (
                    [no] => 20201207000152
                    [title] => 주식등의대량보유상황보고서(일반)
                    [date] => 2020-12-07
                    [submit] => 오광근
                    [href] => http://dart.fss.or.kr/dsaf001/main.do?rcpNo=20201207000152
                    [mhref] => http://m.dart.fss.or.kr/html_mdart/MD1007.html?rcpNo=20201207000152
                )

2021-02-17 수정 : 공시정보에 파일 캐시 기능을 추가함