인증

Benzinga API에 대한 요청을 인증하는 방법

Benzinga API는 요청을 인증하기 위해 API 키를 사용합니다. API 키는 구독에 따라 특정 데이터와 기능에 대한 액세스 권한을 부여하는 고유 식별자입니다.

API 키를 안전하게 보관하세요. GitHub, 클라이언트 측 코드, 암호화되지 않은 통신 등 공개적으로 접근 가능한 곳에 공유하지 마십시오. 키가 유출되었다고 생각되면 즉시 지원팀에 문의하세요.

Benzinga Developer Console에서 API 키를 조회하고 관리할 수 있습니다.

​

인증 방법

Benzinga API는 두 가지 인증 방법을 지원합니다. 프로덕션 환경 애플리케이션에서는 보안성이 더 높고 URL 로그에 키가 노출되는 것을 방지할 수 있으므로 HTTP 헤더 방식을 사용할 것을 강력히 권장합니다.

​

1. HTTP 헤더 (권장)

헤더로 인증하려면 Authorization 헤더에 token <YOUR_API_KEY> 값을 포함하세요.

Authorization: token <YOUR_API_KEY>

​

2. Query Parameter

빠르게 테스트하거나 헤더를 수정할 수 없는 경우, token이라는 이름의 쿼리 파라미터로 키를 전달할 수 있습니다.

https://api.benzinga.com/api/v2/news?token=<YOUR_API_KEY>

​

코드 예시

다음은 여러 주요 언어에서 Benzinga API에 연결하기 위한, 프로덕션 환경에서 바로 사용할 수 있는 예시 코드입니다.

cURL

# 권장: 헤더 인증
curl -L 'https://api.benzinga.com/api/v2/news?pageSize=1' \
-H 'Authorization: token YOUR_API_KEY' \
-H 'Accept: application/json'

# 대안: 쿼리 매개변수
curl -L 'https://api.benzinga.com/api/v2/news?pageSize=1&token=YOUR_API_KEY'

import requests

url = "https://api.benzinga.com/api/v2/news"

# 권장: 헤더 인증
headers = {
    "Authorization": "token YOUR_API_KEY",
    "Accept": "application/json"
}

params = {
    "pageSize": 1
}

try:
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status() # 4xx/5xx 응답에 대해 자세한 오류를 발생시킵니다
    data = response.json()
    print(data)
except requests.exceptions.RequestException as e:
    print(f"데이터 가져오기 오류: {e}")

const axios = require('axios');

const url = 'https://api.benzinga.com/api/v2/news';
const apiKey = 'YOUR_API_KEY';

async function getNews() {
  try {
    const response = await axios.get(url, {
      headers: {
        'Authorization': `token ${apiKey}`,
        'Accept': 'application/json'
      },
      params: {
        pageSize: 1
      }
    });
    
    console.log(response.data);
  } catch (error) {
    if (error.response) {
      // 요청이 전송되었고 서버가 2xx 범위를 벗어나는 상태 코드로 응답한 경우
      console.error('오류 상태:', error.response.status);
      console.error('오류 데이터:', error.response.data);
    } else {
      console.error('오류 메시지:', error.message);
    }
  }
}

getNews();

package main

import (
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	url := "https://api.benzinga.com/api/v2/news?pageSize=1"
	apiKey := "YOUR_API_KEY"

	req, err := http.NewRequest("GET", url, nil)
	if err != nil {
		panic(err)
	}

	// 권장: 헤더 인증
	req.Header.Add("Authorization", fmt.Sprintf("token %s", apiKey))
	req.Header.Add("Accept", "application/json")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	if resp.StatusCode >= 400 {
		fmt.Printf("오류: 상태 코드 %d\n", resp.StatusCode)
		return
	}

	body, err := ioutil.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}

	fmt.Println(string(body))
}

​

문제 해결

일반적인 인증 오류와 해결 방법입니다.

Status Code	Message	Possible Cause	Resolution
401	Unauthorized	잘못된 API 키	API 키가 올바른지, 다시 생성되지 않았는지 확인하십시오. 불필요한 공백이 함께 복사되지 않았는지도 확인하십시오.
401	Unauthorized	API 키 누락	Authorization 헤더가 token <KEY> 형식으로 올바르게 설정되어 있거나 token 파라미터가 포함되어 있는지 확인하십시오.
403	Forbidden	권한 부족	API 키는 유효하지만, 현재 요금제에는 요청한 endpoint에 대한 접근 권한이 포함되어 있지 않습니다. 요금제를 업그레이드하려면 영업팀 또는 지원팀에 문의하십시오.