고객센터

    [주소록 API JSON] 프링고 주소록 API 연동 매뉴얼_json형식(v.3.2)
    • 작성일2022/08/24 16:46
    • 조회 1,397

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

    ● API 연동 정보

     

    - action url : https://안내받으신 메일 서버 도메인 기입/api/address/v2/json-input
    - method : post
    - encoding : UTF-8
    - content-type : application/json

     

     

    ● API 연동 변수명

     

    전송 파라미터 설명 Value값 (예시)
    api_key (필수) 계정관리 - API용 KEY를 그대로 입력 dfd6fd9fsdfbjdnfkd38fndjfd023
    target_id (필수) 발신 주소록의 타겟 ID (숫자만 입력) 3
    title 주소록 그룹 이름 (api 연동을 통해 주소록 그룹생성 시 필수 입력) 회원 뉴스레터 발송 대상자
    description 주소록 그룹 메모 회원 뉴스레터 발송 대상자입니다.
    fields api 연동을 통해 주소록 그룹 생성 시 주소록 필드들 입력 "email, name, etc1, etc2, etc3"
    target_list

    (필수) 등록할 주소록 정보 (이메일, 이름, 기타필드 등)

     [
        {"email": "help@pringo.co.kr","name": "홍길동1","etc1": "회원"},
        {"email": "custom@pringo.co.kr", "name": "홍길동2","etc1": "회원"},
        {"email": "alert@pringo.co.kr","name": "홍길동3","etc1": "비회원"}
     ]

    		  

     

     

     

     

    ● API 연동 변수 입력 예시 (JSON 형식 배열)

     

    Type1 : 등록된 주소록 그룹에 수신자 정보만 등록

    {
     "api_key" : "26b5e58f33cdf79sbkcq3e83e3dd005",
     "target_id" : "38",
     "target_list": [
     {"email": "help@pringo.co.kr","name": "홍길동1","etc1": "회원"},
    {"email": "custom@pringo.co.kr", "name": "홍길동2","etc1": "회원"},
    {"email": "alert@pringo.co.kr","name": "홍길동3","etc1": "비회원"}
     ]
    }

     

    Type2 : 신규 주소록 그룹 생성/등록

    {
     "api_key" : "26b5e58f33cdf79sbkcq3e83e3dd005",
     "title" : "주소록 그룹 이름 (api 연동을 통해 주소록 그룹생성 시 필수 입력)",
     "fields" : "email, name, etc1, etc15, etc16, etc17",
     "target_list": [
     {"email": "help@pringo.co.kr","name": "홍길동1","etc1": "일반텍스트","etc15": "Long TEXT","etc16": "Long TEXT","etc17": "Long TEXT"},
    {"email": "custom@pringo.co.kr", "name": "홍길동2","etc1": "일반텍스트","etc15": "Long TEXT","etc16": "Long TEXT","etc17": "Long TEXT"},
    {"email": "alert@pringo.co.kr","name": "홍길동3","etc1": "일반텍스트","etc15": "Long TEXT","etc16": "Long TEXT","etc17": "Long TEXT"}
     ]
    }

     

     

     

    ● API 호출 테스트 (JSON 형식 연동 방식)

     

    ▶ https://reqbin.com/