Skip to content

OPEN API

TEANAPS edited this page Mar 5, 2022 · 3 revisions

TEANAPS OPEN API

ACCESS TOKEN 발급

  • 무분별한 API 사용을 방지하고자 ACCESS TOKEN 발급을 통해 API 접근권한을 관리합니다.

  • API 호출시 관리자 문의를 통해 발급받은 ACCESS TOKEN을 BODY에 포함해 요청해야 합니다.

  • ACCESS TOKEN 발급은 관리자 이메일([email protected])로 아래 내용을 포함해 문의 바랍니다.

    • 이름 : 홍길동

    • 소속 : 회사/대학교/연구소/그룹 등

    • 사용목적 : "~ 분석/구축 프로젝트" 수행시 감성분석 활용 등

    • 개인정보수집 및 정보활용 동의여부 : Y/N

      Notes :

      • TEANAPS OPEN API의 ACCESS TOKEN은 TEANAPS Python 라이브러리 사용과는 무관합니다.
      • TEANAPS Python 라이브러리는 승인없이 무료로 사용 가능합니다.

TEANAPS OPEN API 리스트

TEANAPS OPEN API는 TEANAPS에서 지원하는 텍스트 분석 기능을 REST API로 제공합니다. 모든 API는 비로그인 방식의 OPEN API로, 호출시 관리자 문의를 통해 발급받은 ACCESS TOKEN을 BODY에 포함해 전송해주셔야 합니다.

  • 기본 요청 URL : http://api.teanaps.com/

  • API 버전 : v1 (2019.7.12 ~)

    API ID 호출방식 응답형식 역할 요청 URL 평균응답속도
    T01-01 HTTP (POST) JSON API 응답체크 /alive 0.029s
    T02-01 HTTP (POST) JSON 형태소분석 /nlp/pos 0.154s
    T02-02 HTTP (POST) JSON 개체명인식 /nlp/ner 0.150s
    T03-01 HTTP (POST) JSON 감성분석 /text_analysis/sentiment 0.676s

    Notes :

    • 평균응답속도는 무선 네트워크 환경에서 API를 요청하고 응답을 받는데 까지 걸리는 시간을 의미하며, 해당 시험결과는 1,000회 연속 API요청에 대한 응답속도의 평균입니다.

TEANAPS OPEN API References

[T01-01] API 응답체크

REST API 동작여부와 ACCESS TOKEN의 유효성을 확인합니다.

  • 요청 파라미터 (Request Parameter)

    파라미터 필수 유형 설명 샘플
    access_token V str ACCESS TOKEN ODMFKGLDICK20190601132625
  • 응답 파라미터 (Response Parameter)

    파라미터 유형 설명 샘플
    code int 응답코드 200
    api_condition str API 상태 free
    access_token_info list ACCESS TOKEN 상태
    ㄴcreated_at str 생성일자 2019-06-01
    ㄴexpiration_in str 생성일자 2019-09-06
  • 호출예시

    Python Code (Request):

    import requests
    
    URL = "http://api.teanaps.com"
    VERSION = "/v1"
    URL_PATTERN = "/alive"
    data = {
        "access_token": "ODMFKGLDICK20190601132625"
    } 
    
    url = URL + VERSION + URL_PATTERN
    r = requests.post(url, data=data)
    j = r.json()
    print(j)

    Output (Response):

    {
      'code': 200,
      'api_condition': 'free',
      'access_token_info': {
        'access_token': 'ODMFKGLDICK20190601132625',
        'created_at': '2019-06-01',
        'expiration_in': '2019-09-06'
      }
    }

[T02-01] 형태소분석

문장을 형태소분석하고 그 결과를 반환합니다.

  • 요청 파라미터 (Request Parameter)

    파라미터 필수 유형 설명 샘플
    access_token V str ACCESS TOKEN ODMFKGLDICK20190601132625
    sentence V str 한국어 또는 영어로 구성된 문장. 최대 128자. 손흥민은 2015년 레버쿠젠에서 토트넘 핫스퍼로 이적했다.
  • 응답 파라미터 (Response Parameter)

    파라미터 유형 설명 샘플
    code int 응답코드 200
    sentence str 요청문장 손흥민은 2015년 레버쿠젠에서 토트넘 핫스퍼로 이적했다.
    pos_list list 형태소분석 결과
    ㄴpos str 형태소 손흥민
    ㄴpos_tag str 품사 태그 NNP
    ㄴner_tag str 개체명 태그 PS
    ㄴlocation list 형태소 위치 [0, 3]
  • 호출예시

    Python Code (Request):

    import requests
    
    URL = "http://api.teanaps.com"
    VERSION = "/v1"
    URL_PATTERN = "/nlp/pos"
    data = {
        "access_token": "ODMFKGLDICK20190601132625",
        "sentence": "손흥민은 2015년 레버쿠젠에서 토트넘 핫스퍼로 이적했다."
    } 
    
    url = URL + VERSION + URL_PATTERN
    r = requests.post(url, data=data)
    j = r.json()
    print(j)

    Output (Response):

    {
      'code': 200,
      'sentence': '손흥민은 2015년 레버쿠젠에서 토트넘 핫스퍼로 이적했다.',
      'pos_list': [
        {
          'pos': '손흥민',
          'pos_tag': 'NNP',
          'ner_tag': 'PS',
          'location': [0, 3]
        },
        {
          'pos': '은',
          'pos_tag': 'JX',
          'ner_tag': 'UN',
          'location': [3, 4]
        },
        ...
        {
          'pos': '다',
          'pos_tag': 'EF',
          'ner_tag': 'UN',
          'location': [30, 31]
        },
        {
          'pos': '.',
          'pos_tag': 'SW',
          'ner_tag': 'UN',
          'location': [31, 32]
        }
      ]
    }

    Notes :

    • TEANAPS 형태소분석 API의 품사태그는 세종말뭉치 품사태그를 기본으로 사용합니다. 품사태그표는 Appendix를 참고해주세요.
    • TEANAPS 형태소분석 API의 성능 및 특징은 성능평가 결과를 참고해주세요.

[T02-02] 개체명인식

문장에서 개체명을 인식하고 그 결과를 반환합니다.

  • 요청 파라미터 (Request Parameter)

    파라미터 필수 유형 설명 샘플
    access_token V str ACCESS TOKEN ODMFKGLDICK20190601132625
    sentence V str 한국어 또는 영어로 구성된 문장. 최대 128자. 손흥민은 2015년 레버쿠젠에서 토트넘 핫스퍼로 이적했다.
  • 응답 파라미터 (Response Parameter)

    파라미터 유형 설명 샘플
    code int 응답코드 200
    sentence str 요청문장 손흥민은 2015년 레버쿠젠에서 토트넘 핫스퍼로 이적했다.
    ner_list list 형태소분석 결과
    ㄴentity str 개체명 손흥민
    ㄴner_tag str 개체명 태그 PS
    ㄴlocation list 개체명 위치 [0, 3]
  • 호출예시

    Python Code (Request):

    import requests
    
    URL = "http://api.teanaps.com"
    VERSION = "/v1"
    URL_PATTERN = "/nlp/ner"
    data = {
        "access_token": "ODMFKGLDICK20190601132625",
        "sentence": "손흥민은 2015년 레버쿠젠에서 토트넘 핫스퍼로 이적했다."
    } 
    
    url = URL + VERSION + URL_PATTERN
    r = requests.post(url, data=data)
    j = r.json()
    print(j)

    Output (Response):

    {
      'code': 200,
      'sentence': '손흥민은 2015년 레버쿠젠에서 토트넘 핫스퍼로 이적했다.',
      'ner_list': [
        {
          'entity': '손흥민',
          'ner_tag': 'PS',
          'location': [0, 3]
        },
        {
          'entity': '2015년',
          'ner_tag': 'DT',
          'location': [5, 10]
        },
        {
          'entity': '레버쿠젠',
          'ner_tag': 'OG',
          'location': [11, 15]
        },
        {
          'entity': '토트넘 핫스퍼',
          'ner_tag': 'OG',
          'location': [18, 25]
        }
      ]
    }

    Notes :

    • TEANAPS 개체명인식 API의 개체명 태그는 총 16종으로 구분됩니다. 태그 종류 및 구분은 정보통신단체표준 (TTAS)을 따릅니다.
    • 개체명 태그표는 Appendix를 참고해주세요.
    • TEANAPS 개체명인식 API의 성능 및 특징은 성능평가 결과를 참고해주세요.

[T03-01] 감성분석

문장의 감성수준을 긍정 또는 부정으로 분류하고 그 결과를 반환합니다.

  • 요청 파라미터 (Request Parameter)

    파라미터 필수 유형 설명 샘플
    access_token V str ACCESS TOKEN ODMFKGLDICK20190601132625
    sentence V str 한국어 또는 영어로 구성된 문장. 최대 128자. 손흥민이 이번 퇴장으로 1년 동안 3번째 퇴장을 기록했다.
  • 응답 파라미터 (Response Parameter)

    파라미터 유형 설명 샘플
    code int 응답코드 200
    sentence str 요청문장 손흥민은 이번 퇴장으로 1년 동안 3번째 퇴장을 기록했다.
    sentiment str 감성수준 negative
    sentiment_score dict
    ㄴpositive float 긍정 스코어 0.0339
    ㄴnegative float 부정 스코어 0.9634
  • 호출예시

    Python Code (Request):

    import requests
    
    URL = "http://api.teanaps.com"
    VERSION = "/v1"
    URL_PATTERN = "/text_analysis/sentiment"
    data = {
        "access_token": "ODMFKGLDICK20190601132625",
        "sentence": "손흥민은 이번 퇴장으로 1년 동안 3번째 퇴장을 기록했다."
    } 
    
    url = URL + VERSION + URL_PATTERN
    r = requests.post(url, data=data)
    j = r.json()
    print(j)

    Output (Response):

    {
      'code': 200,
      'sentence': '손흥민은 이번 퇴장으로 1년 동안 3번째 퇴장을 기록했다.',
      'sentiment': 'negative',
      'sentiment_score': {
        'positive': 0.0339,
        'negative': 0.9634
      }
    }

응답코드

  • 공통 응답코드입니다.

    Code Message DESC
    200 Success 요청이 정상 처리되었습니다.
    401 Incorrect request 요청 파라미터가 잘못되었습니다.
    402 Invalid ACCESS TOKEN ACCESS TOKEN이 유효하지 않습니다.

Contents

◥  HOME
     ▸ Notice
     ▸ What can you do with TEANAPS?
     ▸ Why TEANAPS?

◥  INSTALL GUIDE
     ▸ Docker for Everyone
     ▸ Requirements

◥  WEB SCRAPPER
     ▸ Movie Review Scrapper
     ▸ News Article Scrapper
     ▸ AppStore Review Scrapper
     ▸ PlayStore Review Scrapper
     ▸ Naver Cafe Scrapper

◥  API DOCUMENTATION
     ● Architecture
     ▸ Handler
     ▸ NLP
       └ Morphological Analysis
       └ Named Entity Recognition
       └ Syntax Analysis
       └ Pre-processing
     ▸ Text Analysis
       └ TF/TF-IDF
       └ Document Clustering
       └ Topic Modeling
       └ Co-word/Network Analysis
       └ Sentiment Analysis
       └ Summarization
     ▸ Visualization
     ▸ Machine Learning (TBU)

◥  OPEN API
     ▸ ACCESS TOKEN 발급
     ▸ API 리스트
     ▸ API References

◥  TUTORIAL
     ▸ (TBU)

◥  USE CASES
     ▸ Journal
     ▸ Project
     ▸ Lecture & Seminar

◥  APPENDIX
     ▸ 성능평가 결과
     ▸ 형태소 품사 태그표
     ▸ 개체명 태그표
     ▸ References
     ▸ Release history
     ▸ Update History

Clone this wiki locally