포스트플러스 - 우편 발송 API 코드(Java,Javascript,C#,PHP) 샘플

우편 발송 API 코드 샘플

우편 접수 API 와 접수 상태 조회 API 코드(JavaScript, JAVA, C#, PHP)를 제공합니다.

- 우편 API 발송

- 버전: v1.10

- 제공 언어: JavaScript, JAVA, C#, PHP

- Charset: UTF-8

- Method: POST

우편 접수 API - JavaScript

<!DOCTYPE html>
<html>
<head>
<title>우편 접수 API 코드 샘플</title>
<script type="text/javascript" src="http://code.jquery.com/jquery-3.4.1.min.js"></script>
<script>

function PstMsr() {
    var apiKey = "";

    // master
    var master = new Object();
    var masterCols = ['버전','테스트여부','서비스','연계식별키','봉투','봉투창','흑백칼라','단면양면','배달','템플릿코드','템플릿출력여부','수취인수','여백생성유무','주소페이지유무','맞춤자제유무','메일머지유무','동봉물유무','동봉물페이지수','스테이플러유무','로고파일','발송인명','발송인우편번호','발송인주소','발송인상세주소','발송인전화번호'];
    master.cols = masterCols;

    var masterRows = new Array();
    masterRows.push("v1.10"); // 버전
    masterRows.push("Y"); // 테스트여부
    masterRows.push("PST"); // 서비스
    masterRows.push("POST20230811_000001"); // 연계식별키
    masterRows.push("소봉투"); // 봉투
    masterRows.push("이중창"); // 봉투창
    masterRows.push("흑백"); // 흑백칼라
    masterRows.push("단면"); // 단면양면
    masterRows.push("일반"); // 배달
    masterRows.push(""); // 템플릿코드
    masterRows.push("N"); // 템플릿출력여부
    masterRows.push(2); // 수취인수
    masterRows.push("N"); // 여백생성유무
    masterRows.push("N"); // 주소페이지유무
    masterRows.push("N"); // 맞춤자제유무
    masterRows.push("N"); // 메일머지유무
    masterRows.push("N"); // 동봉물유무
    masterRows.push(0); // 동봉물페이지수
    masterRows.push("N"); // 스테이플러유무
    masterRows.push("N"); // 로고파일
    masterRows.push("포스토피아"); // 발송인명
    masterRows.push("05048"); // 발송인우편번호
    masterRows.push("서울특별시 광진구 강변역로2"); // 발송인주소
    masterRows.push("서울광진우체국 B동 4층"); // 발송인상세주소
    masterRows.push("1577-8114"); // 발송인전화번호
    master.rows = masterRows;


    // detail
    var detail = new Object();
    var detailCols = ['순번','이름','우편번호','주소','상세주소','전화번호','첨부파일','가변1','가변2','가변3'];
    detail.cols = detailCols;
    
    var detailRows = new Array();
    
    var detailRowsArr1 = ['1','홍길동1','31010','서울특별시 광진구 강변역로2','서울광진우체국 B동 1층','01012341234','pstFile.pdf','2021-09-02','대출(고정)','31,000,000'];
    detailRows.push(detailRowsArr1);
    
    var detailRowsArr2 = ['2','홍길동2','08394','서울특별시 광진구 강변역로2','서울광진우체국 B동 2층','01012341234','pstFile.pdf','2021-09-02','대출B(변동)','421,000,000'];
    detailRows.push(detailRowsArr2);
    detail.rows = detailRows;
    
    var pst = new Object();
    pst.master = master;
    pst.detail = detail;

    var pstMsr = JSON.stringify(pst);
    
    console.log(pstMsr);
	/*
	{
		"master":{
			"cols":["버전","테스트여부","서비스","연계식별키","봉투","봉투창","흑백칼라","단면양면","배달","템플릿코드","템플릿출력여부","수취인수","여백생성유무","주소페이지유무","맞춤자제유무","메일머지유무","동봉물유무","동봉물페이지수","스테이플러유무","로고파일","발송인명","발송인우편번호","발송인주소","발송인상세주소","발송인전화번호"],
			"rows":["v1.10","Y","PST","POST20230811_000003","소봉투","이중창","흑백","단면","일반","","N",2,"N","N","N","N","N",0,"N","N","포스토피아","05048","서울특별시 광진구 강변역로2","서울광진우체국 B동 4층","1577-8114"]
		},
		"detail":{
			"cols":["순번","이름","우편번호","주소","상세주소","전화번호","첨부파일","가변1","가변2","가변3"],
			"rows":[
				["1","홍길동1","31010","서울특별시 광진구 강변역로2","서울광진우체국 B동 1층","01012341234","pstFile.pdf","2021-09-02","대출(고정)","31,000,000"],
				["2","홍길동2","08394","서울특별시 광진구 강변역로2","서울광진우체국 B동 2층","01012341234","pstFile.pdf","2021-09-02","대출B(변동)","421,000,000"]
			]
		}
	}
	*/
    
    var formData = new FormData();
    
    formData.append("apiKey", apiKey);

    formData.append('pstFile', new Blob([pstMsr], {type : "application/json"}));
    
    var files = $("input[name=attchFile]")[0].files;
    formData.append("pstFile", files[0]);
    
    $.ajax({
      url: 'https://t.postplus.co.kr/po/api/postplusPstMsrApi.do',
      data: formData,
      cache: false,
      contentType: false,
      processData: false,
      enctype : 'multipart/form-data',
      type: 'POST',
      success: function(data) {
        console.log(data);
      },
      error: function(e) {
        console.log(e);
      }
    });
}

</script>
</head>
<body>
<form>
  <input type="file" name="attchFile">
  <button type="button" onclick="PstMsr()">API 접수</button>
</form>
</body>
</html>

접수 상태 조회 API - JavaScript

                              
<!DOCTYPE html>
<html>
<head>
<title>우편연계 예제</title>
<script type="text/javascript" src="http://code.jquery.com/jquery-3.4.1.min.js"></script>
<script>

function PstMsr() {
    var apiKey = "";
    var inputCode = "POST20230811_000001"; //연계식별키

    var formData = new FormData();
    
    formData.append("apiKey", apiKey);
    formData.append("inputCode", inputCode);

    $.ajax({
      url: 'https://t.postplus.co.kr/po/api/postplusPstStatusApi.do',
      data: formData,
      cache: false,
      contentType: false,
      processData: false,
      enctype : 'multipart/form-data',
      type: 'POST',
      success: function(data) {
        console.log(data);
      },
      error: function(e) {
        console.log(e);
      }
    });
}

</script>
</head>
<body>
<form>
  <button type="button" onclick="PstMsr()">접수 상태 조회 API</button>
</form>
</body>
</html>

우편 접수 API - JAVA

package com.postplus.t;

import org.json.simple.JSONObject;
import org.json.simple.JSONArray;
import java.io.*;
import java.net.*;

public class ApiExample {

    private final String boundary = "===" + System.currentTimeMillis() + "===";
    private final String LINE_FEED = "\r\n";
    
    private final String apiKey = "";

    public void post() throws Exception {
    	String filePath = "d:\\pstFile.pdf";
    	
        // master
        JSONArray masterCols = new JSONArray();
        masterCols.add("버전");
        masterCols.add("테스트여부");
        masterCols.add("서비스");
        masterCols.add("연계식별키");
        masterCols.add("봉투");
        masterCols.add("봉투창");
        masterCols.add("흑백칼라");
        masterCols.add("단면양면");
        masterCols.add("배달");
        masterCols.add("템플릿코드");
        masterCols.add("템플릿출력여부");
        masterCols.add("수취인수");
        masterCols.add("여백생성유무");
        masterCols.add("주소페이지유무");
        masterCols.add("맞춤자제유무");
        masterCols.add("메일머지유무");
        masterCols.add("동봉물유무");
        masterCols.add("동봉물페이지수");
        masterCols.add("스테이플러유무");
        masterCols.add("로고파일");
        masterCols.add("발송인명");
        masterCols.add("발송인우편번호");
        masterCols.add("발송인주소");
        masterCols.add("발송인상세주소");
        masterCols.add("발송인전화번호");

        JSONArray masterRows = new JSONArray();
        masterRows.add("v1.10"); // 버전
        masterRows.add("Y"); // 테스트여부
        masterRows.add("PST"); // 서비스
        masterRows.add("POST20230811_000001"); // 연계식별키
        masterRows.add("소봉투"); // 봉투
        masterRows.add("이중창"); // 봉투창
        masterRows.add("흑백"); // 흑백칼라
        masterRows.add("단면"); // 단면양면
        masterRows.add("일반"); // 배달
        masterRows.add(""); // 템플릿코드
        masterRows.add("N"); // 템플릿출력여부
        masterRows.add(2); // 수취인수
        masterRows.add("N"); // 여백생성유무
        masterRows.add("N"); // 주소페이지유무
        masterRows.add("N"); // 맞춤자제유무
        masterRows.add("N"); // 메일머지유무
        masterRows.add("N"); // 동봉물유무
        masterRows.add(0); // 동봉물페이지수
        masterRows.add("N"); // 스테이플러유무
        masterRows.add("N"); // 로고파일
        masterRows.add("포스토피아"); // 발송인명
        masterRows.add("05048"); // 발송인우편번호
        masterRows.add("서울특별시 광진구 강변역로2"); // 발송인주소
        masterRows.add("서울광진우체국 B동 4층"); // 발송인상세주소
        masterRows.add("1577-8114"); // 발송인전화번호

        JSONObject master = new JSONObject();
        master.put("cols", masterCols);
        master.put("rows", masterRows);


        // detail
        JSONArray detailCols = new JSONArray();
        detailCols.add("순번");
        detailCols.add("이름");
        detailCols.add("우편번호");
        detailCols.add("주소");
        detailCols.add("상세주소");
        detailCols.add("전화번호");
        detailCols.add("첨부파일");
        //detailCols.add("가변1");
        //detailCols.add("가변2");
        //detailCols.add("가변3");

        JSONArray detailRows1 = new JSONArray();
        detailRows1.add("1");
        detailRows1.add("홍길동1");
        detailRows1.add("31010");
        detailRows1.add("서울특별시 광진구 강변역로2");
        detailRows1.add("서울광진우체국 B동 1층");
        detailRows1.add("01012341234");
        detailRows1.add("pstFile.pdf");
        //detailRows1.add("2021-09-02");
        //detailRows1.add("대출(고정)");
        //detailRows1.add("31,000,000");

        JSONArray detailRows2 = new JSONArray();
        detailRows2.add("2");
        detailRows2.add("홍길동2");
        detailRows2.add("08394");
        detailRows2.add("서울특별시 광진구 강변역로2");
        detailRows2.add("서울광진우체국 B동 2층");
        detailRows2.add("01012341234");
        detailRows2.add("pstFile.pdf");
        //detailRows2.add("2021-09-02");
        //detailRows2.add("대출B(변동)");
        //detailRows2.add("421,000,000");

        JSONArray detailRows = new JSONArray();
        detailRows.add(detailRows1);
        detailRows.add(detailRows2);

        JSONObject detail = new JSONObject();
        detail.put("cols", detailCols);
        detail.put("rows", detailRows);

        JSONObject pst = new JSONObject();
        pst.put("master", master);
        pst.put("detail", detail);
        
        /*
		{
		    "master":{
		        "cols":["버전","테스트여부","서비스","연계식별키","봉투","봉투창","흑백칼라","단면양면","배달","템플릿코드","템플릿출력여부","수취인수","여백생성유무","주소페이지유무","맞춤자제유무","메일머지유무","동봉물유무","동봉물페이지수","스테이플러유무","로고파일","발송인명","발송인우편번호","발송인주소","발송인상세주소","발송인전화번호"],
		        "rows":["v1.10","Y","PST","POST20230811_000001","소봉투","이중창","흑백","단면","일반","","N",2,"N","N","N","N","N",0,"N","N","포스토피아","05048","서울특별시 광진구 강변역로2","서울광진우체국 B동 4층","1577-8114"]
		    },
		    "detail":{
		        "cols":["순번","이름","우편번호","주소","상세주소","전화번호","첨부파일"],
		        "rows":[
		            ["1","홍길동1","31010","서울특별시 광진구 강변역로2","서울광진우체국 B동 1층","01012341234","pstFile.pdf"],
		            ["2","홍길동2","08394","서울특별시 광진구 강변역로2","서울광진우체국 B동 2층","01012341234","pstFile.pdf"]
		        ]
		    }
		}        
        */

        // API 전송
        URL url = new URL("https://t.postplus.co.kr/po/api/postplusPstMsrApi.do");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setUseCaches(false);
        conn.setDoOutput(true);
        conn.setDoInput(true);
        conn.setRequestMethod("POST");
        conn.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + boundary);
        conn.setRequestProperty("User-Agent", "CodeJava Agent");
        
        OutputStream ops = conn.getOutputStream();
        PrintWriter writer = new PrintWriter(new OutputStreamWriter(ops, "UTF-8"),true);
        File attchFile = new File(filePath);

        addParam(writer, "apiKey", apiKey);
        addFile(writer, ops, "pstFile", "pst.json", pst.toJSONString());
        addFile(writer, ops, "pstFile", attchFile);
        
        writer.append("--" + boundary + "--").append(LINE_FEED);
        writer.append(LINE_FEED).flush();
        writer.close();
        
        StringBuffer response = new StringBuffer();
        int status = conn.getResponseCode();
        if (status == HttpURLConnection.HTTP_OK) {
            BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            String line;
            while ((line = reader.readLine()) != null) {
                response.append(line);
            }
            reader.close();
            conn.disconnect();
        } else {
            throw new IOException("Server returned non-OK status: " + status);
        }
        System.out.println(response.toString());
    }

    private void addParam(PrintWriter writer, String name, String value) {
        writer.append("--" + boundary).append(LINE_FEED);
        writer.append("Content-Disposition: form-data; name=\"" + name + "\"").append(LINE_FEED);
        writer.append("Content-Type: text/plain; charset=UTF-8").append(LINE_FEED);
        writer.append(LINE_FEED);
        writer.append(value).append(LINE_FEED);
        writer.flush();
    }

    private void addFile(PrintWriter writer, OutputStream ops, String name, File uploadFile) throws IOException {
        String fileName = uploadFile.getName();
        writer.append("--" + boundary).append(LINE_FEED);
        writer.append("Content-Disposition: form-data; name=\"" + name+ "\"; filename=\"" + fileName + "\"").append(LINE_FEED);
        writer.append("Content-Type: "+ URLConnection.guessContentTypeFromName(fileName)).append(LINE_FEED);
        writer.append("Content-Transfer-Encoding: binary").append(LINE_FEED);
        writer.append(LINE_FEED);
        writer.flush();

        FileInputStream is = new FileInputStream(uploadFile);
        byte[] buffer = new byte[4096];
        int bytesRead = -1;
        while ((bytesRead = is.read(buffer)) != -1) {
            ops.write(buffer, 0, bytesRead);
        }
        ops.flush();
        is.close();
        writer.append(LINE_FEED);
        writer.flush();
    }
    
    private void addFile(PrintWriter writer, OutputStream ops, String name, String fileName, String jsonStr) throws IOException {
        writer.append("--" + boundary).append(LINE_FEED);
        writer.append("Content-Disposition: form-data; name=\"" + name+ "\"; filename=\"" + fileName + "\"").append(LINE_FEED);
        writer.append("Content-Type: "+ URLConnection.guessContentTypeFromName(fileName)).append(LINE_FEED);
        writer.append("Content-Transfer-Encoding: binary").append(LINE_FEED);
        writer.append(LINE_FEED);
        writer.flush();

        ByteArrayInputStream is = new ByteArrayInputStream(jsonStr.getBytes());
        byte[] buffer = new byte[4096];
        int bytesRead = -1;
        while ((bytesRead = is.read(buffer)) != -1) {
            ops.write(buffer, 0, bytesRead);
        }
        ops.flush();
        is.close();
        writer.append(LINE_FEED);
        writer.flush();
    }    

}

접수 상태 조회 API - JAVA

                              
package com.postplus.t;

import java.io.*;
import java.net.*;

public class ApiExample {

    private final String boundary = "===" + System.currentTimeMillis() + "===";
    private final String LINE_FEED = "\r\n";
    
    private final String apiKey = "";
    private final String inputCode = "POST20230811_000001"; //연계식별키
    
    public void status() throws Exception {
        // API 전송
        URL url = new URL("https://t.postplus.co.kr/po/api/postplusPstStatusApi.do");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setUseCaches(false);
        conn.setDoOutput(true);
        conn.setDoInput(true);
        conn.setRequestMethod("POST");
        conn.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + boundary);
        conn.setRequestProperty("User-Agent", "CodeJava Agent");
        
        OutputStream ops = conn.getOutputStream();
        PrintWriter writer = new PrintWriter(new OutputStreamWriter(ops, "UTF-8"),true);

        addParam(writer, "apiKey", apiKey);
        addParam(writer, "inputCode", inputCode);
        
        writer.append("--" + boundary + "--").append(LINE_FEED);
        writer.append(LINE_FEED).flush();
        writer.close();
        
        StringBuffer response = new StringBuffer();
        int status = conn.getResponseCode();
        if (status == HttpURLConnection.HTTP_OK) {
            BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            String line;
            while ((line = reader.readLine()) != null) {
                response.append(line);
            }
            reader.close();
            conn.disconnect();
        } else {
            throw new IOException("Server returned non-OK status: " + status);
        }
        System.out.println(response.toString());
    }
    
    private void addParam(PrintWriter writer, String name, String value) {
        writer.append("--" + boundary).append(LINE_FEED);
        writer.append("Content-Disposition: form-data; name=\"" + name + "\"").append(LINE_FEED);
        writer.append("Content-Type: text/plain; charset=UTF-8").append(LINE_FEED);
        writer.append(LINE_FEED);
        writer.append(value).append(LINE_FEED);
        writer.flush();
    }

    private void addFile(PrintWriter writer, OutputStream ops, String name, File uploadFile) throws IOException {
        String fileName = uploadFile.getName();
        writer.append("--" + boundary).append(LINE_FEED);
        writer.append("Content-Disposition: form-data; name=\"" + name+ "\"; filename=\"" + fileName + "\"").append(LINE_FEED);
        writer.append("Content-Type: "+ URLConnection.guessContentTypeFromName(fileName)).append(LINE_FEED);
        writer.append("Content-Transfer-Encoding: binary").append(LINE_FEED);
        writer.append(LINE_FEED);
        writer.flush();

        FileInputStream is = new FileInputStream(uploadFile);
        byte[] buffer = new byte[4096];
        int bytesRead = -1;
        while ((bytesRead = is.read(buffer)) != -1) {
            ops.write(buffer, 0, bytesRead);
        }
        ops.flush();
        is.close();
        writer.append(LINE_FEED);
        writer.flush();
    }
    
    private void addFile(PrintWriter writer, OutputStream ops, String name, String fileName, String jsonStr) throws IOException {
        writer.append("--" + boundary).append(LINE_FEED);
        writer.append("Content-Disposition: form-data; name=\"" + name+ "\"; filename=\"" + fileName + "\"").append(LINE_FEED);
        writer.append("Content-Type: "+ URLConnection.guessContentTypeFromName(fileName)).append(LINE_FEED);
        writer.append("Content-Transfer-Encoding: binary").append(LINE_FEED);
        writer.append(LINE_FEED);
        writer.flush();

        ByteArrayInputStream is = new ByteArrayInputStream(jsonStr.getBytes());
        byte[] buffer = new byte[4096];
        int bytesRead = -1;
        while ((bytesRead = is.read(buffer)) != -1) {
            ops.write(buffer, 0, bytesRead);
        }
        ops.flush();
        is.close();
        writer.append(LINE_FEED);
        writer.flush();
    }    

}

우편 접수 API - C#

using System;
using System.IO;
using System.Net;
using System.Text.Json;

#pragma warning disable SYSLIB0014

namespace TestProject
{
    class Program
    {

        private static void Main()
        {
            try
            {
                string apiKey = ""; //이용하기 전, 발송 IP와 API Key를 확인 합니다.

                string filePath = "d:\\pstFile.pdf";

                // master
                List<string> masterCols = new List<string>();
                masterCols.Add("버전");
                masterCols.Add("테스트여부");
                masterCols.Add("서비스");
                masterCols.Add("연계식별키");
                masterCols.Add("봉투");
                masterCols.Add("봉투창");
                masterCols.Add("흑백칼라");
                masterCols.Add("단면양면");
                masterCols.Add("배달");
                masterCols.Add("템플릿코드");
                masterCols.Add("템플릿출력여부");
                masterCols.Add("수취인수");
                masterCols.Add("여백생성유무");
                masterCols.Add("주소페이지유무");
                masterCols.Add("맞춤자제유무");
                masterCols.Add("메일머지유무");
                masterCols.Add("동봉물유무");
                masterCols.Add("동봉물페이지수");
                masterCols.Add("스테이플러유무");
                masterCols.Add("로고파일");
                masterCols.Add("발송인명");
                masterCols.Add("발송인우편번호");
                masterCols.Add("발송인주소");
                masterCols.Add("발송인상세주소");
                masterCols.Add("발송인전화번호");

                List<object> masterRows = new List<object>();
                masterRows.Add("v1.10"); // 버전
                masterRows.Add("Y"); // 테스트여부
                masterRows.Add("PST"); // 서비스
                masterRows.Add("POST20230811_000001"); // 연계식별키
                masterRows.Add("소봉투"); // 봉투
                masterRows.Add("이중창"); // 봉투창
                masterRows.Add("흑백"); // 흑백칼라
                masterRows.Add("단면"); // 단면양면
                masterRows.Add("일반"); // 배달
                masterRows.Add(""); // 템플릿코드
                masterRows.Add("N"); // 템플릿출력여부
                masterRows.Add(2); // 수취인수
                masterRows.Add("N"); // 여백생성유무
                masterRows.Add("N"); // 주소페이지유무
                masterRows.Add("N"); // 맞춤자제유무
                masterRows.Add("N"); // 메일머지유무
                masterRows.Add("N"); // 동봉물유무
                masterRows.Add(0); // 동봉물페이지수
                masterRows.Add("N"); // 스테이플러유무
                masterRows.Add(""); // 로고파일
                masterRows.Add("포스토피아"); // 발송인명
                masterRows.Add("05048"); // 발송인우편번호
                masterRows.Add("서울특별시 광진구 강변역로2"); // 발송인주소
                masterRows.Add("서울광진우체국 B동 4층"); // 발송인상세주소
                masterRows.Add("1577-8114"); // 발송인전화번호

                Dictionary<string, object> master = new Dictionary<string, object>();
                master.Add("cols", masterCols);
                master.Add("rows", masterRows);

                // detail
                List<string> detailCols = new List<string>();
                detailCols.Add("순번");
                detailCols.Add("이름");
                detailCols.Add("우편번호");
                detailCols.Add("주소");
                detailCols.Add("상세주소");
                detailCols.Add("전화번호");
                detailCols.Add("첨부파일");
                //detailCols.Add("가변1");
                //detailCols.Add("가변2");
                //detailCols.Add("가변3");

                List<string> detailRows1 = new List<string>();
                detailRows1.Add("1");
                detailRows1.Add("홍길동1");
                detailRows1.Add("31010");
                detailRows1.Add("서울특별시 광진구 강변역로2");
                detailRows1.Add("서울광진우체국 B동 1층");
                detailRows1.Add("01012341234");
                detailRows1.Add("pstFile.pdf");
                //detailRows1.Add("2021-09-02");
                //detailRows1.Add("대출(고정)");
                //detailRows1.Add("31,000,000");

                List<string> detailRows2 = new List<string>();
                detailRows2.Add("2");
                detailRows2.Add("홍길동2");
                detailRows2.Add("08394");
                detailRows2.Add("서울특별시 광진구 강변역로2");
                detailRows2.Add("서울광진우체국 B동 2층");
                detailRows2.Add("01012341234");
                detailRows2.Add("pstFile.pdf");
                //detailRows2.Add("2021-09-02");
                //detailRows2.Add("대출(변동)");
                //detailRows2.Add("421,000,000");

                List<object> detailRows = new List<object>();
                detailRows.Add(detailRows1);
                detailRows.Add(detailRows2);

                Dictionary<string, object> detail = new Dictionary<string, object>();
                detail.Add("cols", detailCols);
                detail.Add("rows", detailRows);

                Dictionary<string, object> pst = new Dictionary<string, object>();
                pst.Add("master", master);
                pst.Add("detail", detail);

                byte[] jsonUtf8Bytes =JsonSerializer.SerializeToUtf8Bytes(pst);
                /*
                    {
                        "master":{
                            "cols":["버전","테스트여부","서비스","연계식별키","봉투","봉투창","흑백칼라","단면양면","배달","템플릿코드","템플릿출력여부","수취인수","여백생성유무","주소페이지유무","맞춤자제유무","메일머지유무","동봉물유무","동봉물페이지수","스테이플러유무","로고파일","발송인명","발송인우편번호","발송인주소","발송인상세주소","발송인전화번호"],
                            "rows":["v1.10","Y","PST","POST20230428_000004","소봉투","이중창","흑백","단면","일반","","N",2,"N","N","N","N","N",0,"N","","포스토피아","05048","서울특별시 광진구 강변역로2","서울광진우체국 B동 4층","1577-8114"]
                        },
                        "detail":{
                            "cols":["순번","이름","우편번호","주소","상세주소","전화번호","첨부파일"],
                            "rows":[
                                ["1","홍길동1","31010","서울특별시 광진구 강변역로2","서울광진우체국 B동 1층","01012341234","pstFile.pdf"],
                                ["2","홍길동2","08394","서울특별시 광진구 강변역로2","서울광진우체국 B동 2층","01012341234","pstFile.pdf"]
                            ]
                        }
                    }                
                */

                Dictionary<string, string> parameters = new Dictionary<string, string>();
                parameters.Add("apiKey", apiKey);

                List<object> files = new List<object>();
                files.Add(new FormFile(){Name = "pstFile", FileName = "pst.json", ContentType = "text/plain; charset=UTF-8", Stream = new MemoryStream(jsonUtf8Bytes)});
                files.Add(new FormFile(){Name = "pstFile", FileName = Path.GetFileName(filePath), ContentType = RequestHelper.GetMimeType(filePath), FilePath = filePath});

                string result = RequestHelper.PostMultipart("https://t.postplus.co.kr/po/api/postplusPstMsrApi.do", parameters, files);
                Console.WriteLine(result);
            }
            catch(Exception exception)
            {
                Console.WriteLine(exception);
            }
        }
    }


    public class FormFile
    {
        public string? Name { get; set; } = null;

        public string? FileName { get; set; } = null;
    
        public string? ContentType { get; set; } = null;
    
        public string? FilePath { get; set; } = null;
    
        public Stream? Stream { get; set; } = null;
    }
    
    public class RequestHelper
    {
    
        public static string PostMultipart(string url, Dictionary<string, string>? parameters, List<object>? files)
        {
            string boundary = "===" + DateTime.Now.Ticks.ToString("x") + "===";
            //Console.WriteLine(boundary);
    
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
            request.ContentType = "multipart/form-data; boundary=" + boundary;
            request.Method = "POST";
            request.KeepAlive = true;
            request.Credentials = System.Net.CredentialCache.DefaultCredentials;
            request.UserAgent = "CodeC# Agent";
    
            using (Stream requestStream = request.GetRequestStream())
            {
                if (parameters != null && parameters.Count > 0)
                {
                    foreach (KeyValuePair<string, string> pair in parameters)
                    {
                        //write boundary
                        byte[] boundaryBytes = System.Text.Encoding.UTF8.GetBytes("--" + boundary + "\r\n");
                        requestStream.Write(boundaryBytes, 0, boundaryBytes.Length);

                        string data = string.Format("Content-Disposition: form-data; name=\"{0}\"\r\nContent-Type: text/plain; charset=UTF-8\r\n\r\n{1}\r\n",
                                            pair.Key,
                                            pair.Value);
                        //Console.WriteLine(data);
                        byte[] bytes = System.Text.Encoding.UTF8.GetBytes(data);
                        requestStream.Write(bytes, 0, bytes.Length);
                    }
                }

                if (files != null && files.Count > 0)
                {
                    foreach (FormFile file in files)
                    {
                        //write boundary
                        byte[] boundaryBytes = System.Text.Encoding.UTF8.GetBytes("--" + boundary + "\r\n");
                        requestStream.Write(boundaryBytes, 0, boundaryBytes.Length);

                        string data = string.Format("Content-Disposition: form-data; name=\"{0}\"; filename=\"{1}\"\r\nContent-Type: {2}\r\nContent-Transfer-Encoding: binary\r\n\r\n",
                                            file.Name,
                                            file.FileName,
                                            file.ContentType);
                        //Console.WriteLine(header);
                        byte[] bytes = System.Text.Encoding.UTF8.GetBytes(data);
                        requestStream.Write(bytes, 0, bytes.Length);

                        byte[] buffer = new byte[32768];
                        int bytesRead;
                        if (file.FilePath != null)
                        {
                            // upload from file
                            using (FileStream fileStream = File.OpenRead(file.FilePath))
                            {
                                while ((bytesRead = fileStream.Read(buffer, 0, buffer.Length)) != 0)
                                    requestStream.Write(buffer, 0, bytesRead);
                                fileStream.Close();
                            }
                        }
                        else if (file.Stream != null)
                        {
                            // upload from given stream
                            while ((bytesRead = file.Stream.Read(buffer, 0, buffer.Length)) != 0)
                                requestStream.Write(buffer, 0, bytesRead);
                        }
                        else {
                            throw new ArgumentException("FilePath or Stream cannot be null");
                        }

                        byte[] linefeedBytes = System.Text.Encoding.UTF8.GetBytes("\r\n");
                        requestStream.Write(linefeedBytes, 0, linefeedBytes.Length);
                    }
                }

                byte[] tailBytes = System.Text.Encoding.UTF8.GetBytes("--" + boundary + "--\r\n\r\n");
                requestStream.Write(tailBytes, 0, tailBytes.Length);

                requestStream.Close();
            }
    
            using (WebResponse response = request.GetResponse())
            {
                using (Stream responseStream = response.GetResponseStream())
                using (StreamReader reader = new StreamReader(responseStream))
                    return reader.ReadToEnd();
            }
        }
        public bool AcceptAllCertifications(object sender, System.Security.Cryptography.X509Certificates.X509Certificate certification, System.Security.Cryptography.X509Certificates.X509Chain chain, System.Net.Security.SslPolicyErrors sslPolicyErrors)
        {
            return true;
        }

        private static IDictionary<string, string> _mappings = new Dictionary<string, string>(StringComparer.InvariantCultureIgnoreCase) {
            {".pdf", "application/pdf"},
            {".zip", "application/x-zip-compressed"}
        };

        public static string GetMimeType(string fileName)
        {
            string extension = Path.GetExtension(fileName);

            if (extension == null)
            {
                throw new ArgumentNullException("extension");
            }

            if (!extension.StartsWith("."))
            {
                extension = "." + extension;
            }
            
            string? mime = null;
            return _mappings.TryGetValue(extension, out mime) ? mime : "application/octet-stream";
        }

    }

}

접수 상태 조회 API - C#

                              
using System;
using System.IO;
using System.Net;
using System.Text.Json;

#pragma warning disable SYSLIB0014

namespace TestProject
{
    class Program
    {

        private static void Main()
        {
            try
            {
                string apiKey = "";
                string inputCode = "POST20230811_000001"; //연계식별키

                Dictionary<string, string> parameters = new Dictionary<string, string>();
                parameters.Add("apiKey", apiKey);
                parameters.Add("inputCode", inputCode);

                string result = RequestHelper.PostMultipart("https://t.postplus.co.kr/po/api/postplusPstStatusApi.do", parameters, null);
                Console.WriteLine(result);
            }
            catch(Exception exception)
            {
                Console.WriteLine(exception);
            }
        }
    }


    public class FormFile
    {
        public string? Name { get; set; } = null;

        public string? FileName { get; set; } = null;
    
        public string? ContentType { get; set; } = null;
    
        public string? FilePath { get; set; } = null;
    
        public Stream? Stream { get; set; } = null;
    }
    
    public class RequestHelper
    {
    
        public static string PostMultipart(string url, Dictionary<string, string>? parameters, List<object>? files)
        {
            string boundary = "===" + DateTime.Now.Ticks.ToString("x") + "===";
            //Console.WriteLine(boundary);
    
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
            request.ContentType = "multipart/form-data; boundary=" + boundary;
            request.Method = "POST";
            request.KeepAlive = true;
            request.Credentials = System.Net.CredentialCache.DefaultCredentials;
            request.UserAgent = "CodeC# Agent";
    
            using (Stream requestStream = request.GetRequestStream())
            {
                if (parameters != null && parameters.Count > 0)
                {
                    foreach (KeyValuePair<string, string> pair in parameters)
                    {
                        //write boundary
                        byte[] boundaryBytes = System.Text.Encoding.UTF8.GetBytes("--" + boundary + "\r\n");
                        requestStream.Write(boundaryBytes, 0, boundaryBytes.Length);

                        string data = string.Format("Content-Disposition: form-data; name=\"{0}\"\r\nContent-Type: text/plain; charset=UTF-8\r\n\r\n{1}\r\n",
                                            pair.Key,
                                            pair.Value);
                        //Console.WriteLine(data);
                        byte[] bytes = System.Text.Encoding.UTF8.GetBytes(data);
                        requestStream.Write(bytes, 0, bytes.Length);
                    }
                }

                if (files != null && files.Count > 0)
                {
                    foreach (FormFile file in files)
                    {
                        //write boundary
                        byte[] boundaryBytes = System.Text.Encoding.UTF8.GetBytes("--" + boundary + "\r\n");
                        requestStream.Write(boundaryBytes, 0, boundaryBytes.Length);

                        string data = string.Format("Content-Disposition: form-data; name=\"{0}\"; filename=\"{1}\"\r\nContent-Type: {2}\r\nContent-Transfer-Encoding: binary\r\n\r\n",
                                            file.Name,
                                            file.FileName,
                                            file.ContentType);
                        //Console.WriteLine(header);
                        byte[] bytes = System.Text.Encoding.UTF8.GetBytes(data);
                        requestStream.Write(bytes, 0, bytes.Length);

                        byte[] buffer = new byte[32768];
                        int bytesRead;
                        if (file.FilePath != null)
                        {
                            // upload from file
                            using (FileStream fileStream = File.OpenRead(file.FilePath))
                            {
                                while ((bytesRead = fileStream.Read(buffer, 0, buffer.Length)) != 0)
                                    requestStream.Write(buffer, 0, bytesRead);
                                fileStream.Close();
                            }
                        }
                        else if (file.Stream != null)
                        {
                            // upload from given stream
                            while ((bytesRead = file.Stream.Read(buffer, 0, buffer.Length)) != 0)
                                requestStream.Write(buffer, 0, bytesRead);
                        }
                        else {
                            throw new ArgumentException("FilePath or Stream cannot be null");
                        }

                        byte[] linefeedBytes = System.Text.Encoding.UTF8.GetBytes("\r\n");
                        requestStream.Write(linefeedBytes, 0, linefeedBytes.Length);
                    }
                }

                byte[] tailBytes = System.Text.Encoding.UTF8.GetBytes("--" + boundary + "--\r\n\r\n");
                requestStream.Write(tailBytes, 0, tailBytes.Length);

                requestStream.Close();
            }
    
            using (WebResponse response = request.GetResponse())
            {
                using (Stream responseStream = response.GetResponseStream())
                using (StreamReader reader = new StreamReader(responseStream))
                    return reader.ReadToEnd();
            }
        }
        public bool AcceptAllCertifications(object sender, System.Security.Cryptography.X509Certificates.X509Certificate certification, System.Security.Cryptography.X509Certificates.X509Chain chain, System.Net.Security.SslPolicyErrors sslPolicyErrors)
        {
            return true;
        }

        private static IDictionary<string, string> _mappings = new Dictionary<string, string>(StringComparer.InvariantCultureIgnoreCase) {
            {".pdf", "application/pdf"},
            {".zip", "application/x-zip-compressed"}
        };

        public static string GetMimeType(string fileName)
        {
            string extension = Path.GetExtension(fileName);

            if (extension == null)
            {
                throw new ArgumentNullException("extension");
            }

            if (!extension.StartsWith("."))
            {
                extension = "." + extension;
            }
            
            string? mime = null;
            return _mappings.TryGetValue(extension, out mime) ? mime : "application/octet-stream";
        }

    }

}

우편 접수 API - PHP

<?php
$apiKey = ""; //이용하기 전, 발송 IP와 API Key를 확인 합니다.
$filePath = "d:\\pstFile.pdf";

$apiUrl = "https://t.postplus.co.kr/po/api/postplusPstMsrApi.do";

$masterCols = array();
$masterCols[] = "버전";
$masterCols[] = "테스트여부";
$masterCols[] = "서비스";
$masterCols[] = "연계식별키";
$masterCols[] = "봉투";
$masterCols[] = "봉투창";
$masterCols[] = "흑백칼라";
$masterCols[] = "단면양면";
$masterCols[] = "배달";
$masterCols[] = "템플릿코드";
$masterCols[] = "템플릿출력여부";
$masterCols[] = "수취인수";
$masterCols[] = "여백생성유무";
$masterCols[] = "주소페이지유무";
$masterCols[] = "맞춤자제유무";
$masterCols[] = "메일머지유무";
$masterCols[] = "동봉물유무";
$masterCols[] = "동봉물페이지수";
$masterCols[] = "스테이플러유무";
$masterCols[] = "로고파일";
$masterCols[] = "발송인명";
$masterCols[] = "발송인우편번호";
$masterCols[] = "발송인주소";
$masterCols[] = "발송인상세주소";
$masterCols[] = "발송인전화번호";

$masterRows = array();
$masterRows[] = "v1.10"; // 버전
$masterRows[] = "Y"; // 테스트여부
$masterRows[] = "PST"; // 서비스
$masterRows[] = "POST20230811_000001"; // 연계식별키
$masterRows[] = "소봉투"; // 봉투
$masterRows[] = "이중창"; // 봉투창
$masterRows[] = "흑백"; // 흑백칼라
$masterRows[] = "단면"; // 단면양면
$masterRows[] = "일반"; // 배달
$masterRows[] = ""; // 템플릿코드
$masterRows[] = "N"; // 템플릿출력여부
$masterRows[] = 2; // 수취인수
$masterRows[] = "N"; // 여백생성유무
$masterRows[] = "N"; // 주소페이지유무
$masterRows[] = "N"; // 맞춤자제유무
$masterRows[] = "N"; // 메일머지유무
$masterRows[] = "N"; // 동봉물유무
$masterRows[] = 0; // 동봉물페이지수
$masterRows[] = "N"; // 스테이플러유무
$masterRows[] = "N"; // 로고파일
$masterRows[] = "포스토피아"; // 발송인명
$masterRows[] = "05048"; // 발송인우편번호
$masterRows[] = "서울특별시 광진구 강변역로2"; // 발송인주소
$masterRows[] = "서울광진우체국 B동 4층"; // 발송인상세주소
$masterRows[] = "1577-8114"; // 발송인전화번호

$master = array();
$master["cols"] = $masterCols;
$master["rows"] = $masterRows;


// detail
$detailCols = array();
$detailCols[] = "순번";
$detailCols[] = "이름";
$detailCols[] = "우편번호";
$detailCols[] = "주소";
$detailCols[] = "상세주소";
$detailCols[] = "전화번호";
$detailCols[] = "첨부파일";
//$detailCols[] = "가변1";
//$detailCols[] = "가변2";
//$detailCols[] = "가변3";

$detailRows1 = array();
$detailRows1[] = "1";
$detailRows1[] = "홍길동1";
$detailRows1[] = "31010";
$detailRows1[] = "서울특별시 광진구 강변역로2";
$detailRows1[] = "서울광진우체국 B동 1층";
$detailRows1[] = "01012341234";
$detailRows1[] = "pstFile.pdf";
//$detailRows1[] = "2021-09-02";
//$detailRows1[] = "대출(고정)";
//$detailRows1[] = "31,000,000";

$detailRows2 = array();
$detailRows2[] = "2";
$detailRows2[] = "홍길동2";
$detailRows2[] = "08394";
$detailRows2[] = "서울특별시 광진구 강변역로2";
$detailRows2[] = "서울광진우체국 B동 2층";
$detailRows2[] = "01012341234";
$detailRows2[] = "pstFile.pdf";
//$detailRows2[] = "2021-09-02";
//$detailRows2[] = "대출B(변동)";
//$detailRows2[] = "421,000,000";

$detailRows = array();
$detailRows[] = $detailRows1;
$detailRows[] = $detailRows2;

$detail = array();
$detail["cols"] =  $detailCols;
$detail["rows"] = $detailRows;

$pst = array();
$pst["master"] =  $master;
$pst["detail"] =  $detail;

$json = json_encode($pst, JSON_UNESCAPED_UNICODE);
//echo($json);
/*
{
	"master":{
		"cols":["버전","테스트여부","서비스","연계식별키","봉투","봉투창","흑백칼라","단면양면","배달","템플릿코드","템플릿출력여부","수취인수","여백생성유무","주소페이지유무","맞춤자제유무","메일머지유무","동봉물유무","동봉물페이지수","스테이플러유무","로고파일","발송인명","발송인우편번호","발송인주소","발송인상세주소","발송인전화번호"],
		"rows":["v1.10","Y","PST","POST20230811_000001","소봉투","이중창","흑백","단면","일반","","N",2,"N","N","N","N","N",0,"N","N","포스토피아","05048","서울특별시 광진구 강변역로2","서울광진우체국 B동 4층","1577-8114"]
	},
	"detail":{
		"cols":["순번","이름","우편번호","주소","상세주소","전화번호","첨부파일"],
		"rows":[
			["1","홍길동1","31010","서울특별시 광진구 강변역로2","서울광진우체국 B동 1층","01012341234","pstFile.pdf"],
			["2","홍길동2","08394","서울특별시 광진구 강변역로2","서울광진우체국 B동 2층","01012341234","pstFile.pdf"]
		]
	}
}        
*/


$boundary = '-------------' . uniqid();
$eol = "\r\n";

//apiKey
$post_data = "--" . $boundary . $eol
    . 'Content-Disposition: form-data; name="apiKey"' . $eol
    . 'Content-Type: text/plain; charset=UTF-8' . $eol . $eol
    . $apiKey . $eol;

//master/deatil json
$post_data .= "--" . $boundary . $eol
    . 'Content-Disposition: form-data; name="pstFile"; filename="pst.json"' . $eol
    . 'Content-Type: text/plain; charset=UTF-8'.$eol
    . 'Content-Transfer-Encoding: binary' . $eol . $eol;
$post_data .= $json . $eol;

//내용문 파일
$post_data .= "--" . $boundary . $eol
    . 'Content-Disposition: form-data; name="pstFile"; filename="' . basename($filePath) . '"' . $eol
    . 'Content-Type: ' . mime_content_type($filePath) . $eol
    . 'Content-Transfer-Encoding: binary' . $eol . $eol;
$post_data .= file_get_contents($filePath) . $eol;

//end
$post_data .= "--" . $boundary . "--" . $eol;



$ch = curl_init();

curl_setopt_array($ch, array(
  CURLOPT_URL => $apiUrl,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => $post_data,
  CURLOPT_USERAGENT => "CodePhp Agent",
  CURLOPT_SSL_VERIFYPEER => false,
  CURLOPT_HTTPHEADER => array(
    "Content-Type: multipart/form-data; boundary=" . $boundary,
    "Content-Length: " . strlen($post_data)
  ),
));

$ret = curl_exec($ch);
$err = curl_error($ch);
curl_close($ch);

if($err) {
	echo "cURL Error #:" . $err;
} else {
	echo $ret;
	$retArr = json_decode($ret); // 결과
	//print_r($retArr);
} 


?>

접수 상태 조회 API - PHP

                              
<?php
$apiKey = ""; //이용하기 전, 발송 IP와 API Key를 확인 합니다.
$inputCode = "POST20230811_000001"; //연계식별키

$apiUrl = "https://t.postplus.co.kr/po/api/postplusPstStatusApi.do";

$params = array();
$params["apiKey"] =  $apiKey;
$params["inputCode"] =  $inputCode;

$ch = curl_init();

curl_setopt_array($ch, array(
  CURLOPT_URL => $apiUrl,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => $params,
  CURLOPT_USERAGENT => "CodePhp Agent",
  CURLOPT_SSL_VERIFYPEER => false,
  CURLOPT_HTTPHEADER => array("Content-Type: multipart/form-data;"),
));

$ret = curl_exec($ch);
$err = curl_error($ch);
curl_close($ch);

if($err) {
	echo "cURL Error #:" . $err;
} else {
	echo $ret;
	$retArr = json_decode($ret); // 결과
	//print_r($retArr);
} 


?>

포스트플러스 (주)포스토피아
서울특별시 광진구 강변역로2 (구의동, 서울광진우체국 B동 4층)
대표이사 : 김성규

사업자등록번호 : 215-86-50542
통신판매업 신고번호 : 2013-서울광진-0641호
개인정보보호책임자 : 정연석

대표번호 : 1577-8114
팩스 : 02-2279-9170
이메일 : postbiz@epostopia.com