회원 등록

개요

  • 신규 회원 정보를 등록하는 API
  • 협력기관 전용 API입니다.

요청

  • URL: https://doi.or.kr/manage/api/v2/depositor
  • HTTP Method: POST
  • Content-Type: application/json
  • 요청 본문
필드 타입 설명 필수 기본값
key
String 협력기관별로 발급된 API 키 -
depositor
Object 등록기관 정보 -
id
String 등록기관 ID -
password
String 비밀번호 -
name
String 등록기관명 -
name_abbr
String 등록기관명 약칭 -
name_org
String 등록기관명 영문 -
president
Object 기관대표 -
name
String 기관대표명 -
email
String 기관대표 이메일 -
postal_code
String 우편번호 -
address
String 주소 -
business_number
String 사업자등록번호 -
business_type
String 업태/종목 -
depositor_type
String 기관유형 코드(하단 코드 표 참조) -
main_contact
Object 실무책임자(정) -
name
String 성명 -
email
String 이메일 -
phone
String 전화번호(사무실) -
mobile_phone
String 전화번호(휴대폰) -
fax
String 팩스번호 -
sub_contact
Object 실무책임자(부) -
name
String 성명 -
email
String 이메일 -
phone
String 전화번호(사무실) -
mobile_phone
String 전화번호(휴대폰) -
fax
String 팩스번호 -
* 기관유형 코드
코드 기관 유형
SOCIETY 학회
PUBLISHER 출판사
DISTRIBUTION 정보유통자
PUBLIC 공공기관
ETC 기타

응답

  • Content-Type: application/json
  • 응답 본문
필드 타입 설명
result
String SUCCESS/FAIL
data
Object result 값이 SUCCESS 일 경우 반환되는 데이터
depositor_id
String 등록된 기관 ID 값
key
String 발급된 API 키 값
error
Object result 값이 FAIL 일 경우 반환되는 데이터
code
String 오류 코드
message
String 오류 메시지

오류코드

HTTP 코드 코드 오류
401 MISSING_KEY 필수 입력값(KEY)이 누락되었습니다.
401 INVALID_KEY API키가 올바르지 않습니다.
400 MISSING_DEPOSITOR 등록기관 정보가 없습니다.
400 MISSING_DEPOSITOR_ID 등록기관 ID가 없습니다.
400 EXIST_DEPOSITOR_ID 등록기관ID가 이미 존재합니다.
400 MISSING_PASSWORD 비밀번호가 없습니다.
400 INVALID_PASSWORD_FORMAT 비밀번호가 유효하지 않습니다. (영어, 숫자, 특수문자를 포함하여 8~16자리)
400 MISSING_DEPOSITOR_NAME 등록기관명이 없습니다.
400 MISSING_PRESIDENT 기관대표 정보가 없습니다.
400 MISSING_PRESIDENT_NAME 기관대표명이 없습니다.
400 MISSING_PRESIDENT_EMAIL 기관대표 이메일이 없습니다.
400 INVALID_PRESIDENT_EMAIL_FORMAT 기관대표의 이메일 형식을 올바르게 입력해 주세요.
400 MISSING_ADDRESS 주소 정보가 없습니다.
400 MISSING_DEPOSITOR_TYPE 기관유형 정보가 없습니다.
400 INVALID_DEPOSITOR_TYPE 올바른 기관유형 코드를 입력해주세요.
400 MISSING_MAIN_CONTACT 실무책임자(정) 정보가 없습니다.
400 MISSING_MAIN_CONTACT_NAME 실무책임자(정) 성명이 없습니다.
400 MISSING_MAIN_CONTACT_EMAIL 실무책임자(정) 이메일이 없습니다.
400 INVALID_MAIN_CONTACT_EMAIL_FORMAT 실무책임자(정) 이메일 형식을 올바르게 입력해 주세요.
400 INVALID_SUB_CONTACT_EMAIL_FORMAT 실무책임자(부) 이메일 형식을 올바르게 입력해 주세요.