이 코드는 네이버 검색광고에서 제공하는 키워드 도구 API를 호출하여
특정 키워드와 연관된 검색 키워드 데이터를 조회하는 역할을 한다.

API 인증 절차부터 요청 생성, 응답 처리까지의 전 과정을 하나의 함수로 캡슐화하여
외부에서는 키워드 문자열만 전달하면 결과를 받을 수 있도록 구성되어 있다.

API 인증 정보 설정

상단에는 네이버 검색광고 API 호출에 필요한 인증 정보가 상수로 정의되어 있다.

• ACCESS_LICENSE
• SECRET_KEY
• CUSTOMER_ID

이 값들은 네이버 검색광고 관리자 센터에서 발급받는 정보이며,
요청 시 HTTP 헤더에 포함되어 API 사용 권한을 검증하는 데 사용된다.

코드 내에서 상수로 분리함으로써
인증 정보 변경 시 유지보수가 용이하도록 설계되어 있다.

키워드 조회 함수 구조

fetchKeyword 함수는 키워드 도구 API 호출을 담당하는 핵심 로직이다.

입력값으로 하나 이상의 키워드를 문자열 형태로 전달받아
해당 키워드를 기반으로 한 연관 키워드 목록을 반환한다.

함수의 반환값은 배열 형태이며,
API 응답이 정상적이지 않은 경우 빈 배열을 반환하도록 처리되어 있다.

타임스탬프 및 서명 생성

API 요청 시 보안을 위해 타임스탬프와 서명이 필요하다.

타임스탬프는 밀리초 단위의 현재 시간으로 생성되며,
요청 시점의 유효성을 검증하는 용도로 사용된다.

서명은 다음 요소를 결합하여 생성된다.

• 타임스탬프
• HTTP 메서드
• 요청 경로

이 값을 SECRET_KEY를 이용해 HMAC-SHA256 방식으로 해시한 뒤
Base64로 인코딩하여 최종 서명을 만든다.

이 서명은 요청이 위변조되지 않았음을 증명하는 역할을 한다.

API 요청 구성

cURL을 사용하여 HTTP GET 요청을 생성한다.

요청 URL에는 다음 정보가 포함된다.

• hintKeywords
• showDetail 옵션

hintKeywords는 조회 대상 키워드이며
URL 인코딩을 통해 안전하게 전달된다.

HTTP 헤더에는 앞서 생성한 인증 정보가 포함된다.

• X-Timestamp
• X-API-KEY
• X-CUSTOMER
• X-Signature

이를 통해 네이버 서버는 요청자의 신원을 확인하고
요청의 유효성을 검증한다.

응답 처리 방식

API 호출 결과는 JSON 문자열 형태로 반환된다.

이를 배열로 디코딩한 뒤
keywordList 항목만 추출하여 반환한다.

만약 응답에 해당 항목이 존재하지 않을 경우
null 병합 연산자를 통해 빈 배열을 반환하도록 처리되어 있다.

// 네이버 키워드 도구 API 설정
define('ACCESS_LICENSE', '');
define('SECRET_KEY', '');
define('CUSTOMER_ID', '');

// 키워드 검색 함수
function fetchKeyword($keywords) {
    $timestamp = (string) round(microtime(true) * 1000);
    $signature = base64_encode(hash_hmac('sha256', $timestamp.'.GET./keywordstool', SECRET_KEY, true));

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://api.searchad.naver.com/keywordstool?hintKeywords='.urlencode($keywords).'&showDetail=1');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'X-Timestamp: '.$timestamp,
        'X-API-KEY: '.ACCESS_LICENSE,
        'X-CUSTOMER: '.CUSTOMER_ID,
        'X-Signature: '.$signature
    ]);
    $data = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $data['keywordList'] ?? [];
}