Quick Start

Last updated: 2016.9.29

시작하기

HTTP RestfulAPI 를 이용한 UN7 서비스는 아주 쉽고 간단한게 원하는 서비스를 만들수 있도록 지원 합니다.

일간 운세 조회하기

요청 타입
키 값 설명
Content-Type Application/x-www-form-urlencode html form에 method 를 GET으로 설정한거에요
일간 운세 요청 파라미터
키 예제 설명
targetYear 2016 운세를 보고자 하는 날의 년
targetMonth 9 운세를 보고자 하는 날의 월
targetDay 21 운세를 보고자 하는 날의 일
birthYear 1991 운세를 보고자 하는 사람의 생년
birthMonth 11 운세를 보고자 하는 사람의 생월
birthDay 23 운세를 보고자 하는 사람의 생일
birthDay 23 운세를 보고자 하는 사람의 생시(24시간)
isLunar false 생일의 음역 여부 / 양력일 경우 false


일간 운세 조회 결과 타입
키 값 설명
Content-Type Application/json JSON 포멧 String 데이터
일간 운세 조회 결과
키 타입 예제 설명
code 숫자(정수) 200 조회 결과 코드
message 문자열 "OK" 운세를 보고자 하는 날의 월
data JSON 
{
    "day01": {
        "title": "현재의운",
        "description": "전반적으로 ...... 하겠습니다. "
    },
    "day02": {
        "title": "현재(월)의 길흉사",
        "description": "역마의것이 ...... 있겠습니다."
    },
    "day03": {
        "title": "현재의 행운색상",
        "description": "현재 당신에게는 더 ...... 있습니다. "
    },
    "day07": {
        "title": "현재의 사업거래운",
        "description": "외부적으로는 ....... 있겠습니다."
    },
    "day08": {
        "title": "현재의 연인애정운",
        "description": "애정운은 ....... 있겠습니다."
    },
    "day09": {
        "title": "현재의 건강질병운",
        "description": "전반적으로 ....... 합니다."
    },
    "day10": {
        "title": "현재의 여행이사운",
        "description": "이사는 ...... 있겠습니다. "
    },
    "day11": {
        "title": "직장관록운",
        "description": "취업은 ...... 있겠습니다. "
    },
    "day04": {
        "title": "행운을 가져다줄 성씨",
        "description": "▣ 박, 정,  ...... 하겠습니다. "
    },
    "day06": {
        "title": "현재 운세풀이",
        "description": "사람과 교제를 ..... 하겠습니다. "
    }
}
운세 조회 결과 입니다.

일간 운세 조회 샘플 코드

테스트용 키 : 943156c8f56a4c88fad1ba1379e3bf00

샘플코드에 제공된 KEY는 테스트용으로 발급된 키 입니다. 실제로 조회된 운세 정보가 아니며, 파라미터 확인용으로만 사용 됩니다. 실제 운영시에는 필이 운영용 key를 별도로 발급받아서 사용 해주세요.

CURL

$ curl -G -L -d "targetYear=2016&targetMonth=9&targetDay=27&birthYear=1984&birthMonth=5&birthDay=25&birthHour=17&isLunar=false&api-key=943156c8f56a4c88fad1ba1379e3bf00" "https://api.un7.kr/api/v1/day"
PHP
<?php
$param = array(
    'api-key' => '943156c8f56a4c88fad1ba1379e3bf00',    //API KEY
    'targetYear' => 2016,                               //운세를 보고자 하는 날의 년
    'targetMonth' => 9,                                 //운세를 보고자 하는 날의 월
    'targetDay' => 11,                                  //운세를 보고자 하는 날의 일
    'birthYear' => 1980,                                //생년
    'birthMonth' => 11,                                 //생월
    'birthDay' => 9,                                    //생일
    'birthHour' => 11,                                  //생시
    'isLunar' => 'false',                               //음력 여부, 양력이면 false로 주세요
                                                        //값을 String 형태로 주는걸 잊지 마세요
);

$data = http_build_query($param);

$url = 'https://api.un7.kr/api/v1/day';
$timeout = 5;   //timout을 5초로 한다.

$ch = curl_init();
curl_setopt($ch,CURLOPT_URL,$url."?".$data);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_TIMEOUT, 5);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

$output = curl_exec($ch);

curl_close($ch);

//JSON 형태의 결과를 Array로 변환한다.
$fortune_result = json_decode($output,true);

//결과를 출력한다.
print_r($fortune_result);
?>
JAVA
String url = "https://api.un7.kr/api/v1/day";

String queryString = "targetYear={TARGET_YEAR}&targetMonth={TARGET_MONTH}&targetDay={TARGET_DAY}"
                    + "&birthYear={BIRTH_YEAR}&birthMonth={BIRTH_MONTH}&birthDay={BIRTH_DAY}&birthHour={BIRTH_HOUR}"
                    + "&isLunar={IS_LUNAR}"
                    + "&api-key={API_KEY}";
queryString = queryString.replace("{API_KEY}", "943156c8f56a4c88fad1ba1379e3bf00"); //API KEY
queryString = queryString.replace("{TARGET_YEAR}", "2016");          //운세를 보고자 하는 날의 년
queryString = queryString.replace("{TARGET_MONTH}", "9");			 //운세를 보고자 하는 날의 월
queryString = queryString.replace("{TARGET_DAY}", "15");			 //운세를 보고자 하는 날의 일
queryString = queryString.replace("{BIRTH_YEAR}", "1980");			 //생년
queryString = queryString.replace("{BIRTH_MONTH}", "6");			 //생월
queryString = queryString.replace("{BIRTH_DAY}", "30");				 //생일
queryString = queryString.replace("{BIRTH_HOUR}", "12");			 //생시
queryString = queryString.replace("{IS_LUNAR}", "false");			 //음력 여부, 양력이면 false로 주세요.

URL obj = new URL(url + "?" + queryString);
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
con.setConnectTimeout(5000);
con.setReadTimeout(5000);

BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));

String inputLine;
StringBuffer response = new StringBuffer();

while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();

System.out.println(response.toString());

연간 운세 조회하기

요청 타입
키 값 설명
Content-Type Application/x-www-form-urlencode html form에 method 를 GET으로 설정한거에요
연간 운세 요청 파라미터
키 예제 설명
targetYear 2016 운세를 보고자 하는 날의 년
birthYear 1991 운세를 보고자 하는 사람의 생년
birthMonth 11 운세를 보고자 하는 사람의 생월
birthDay 23 운세를 보고자 하는 사람의 생일
birthDay 23 운세를 보고자 하는 사람의 생시(24시간)
isLunar false 생일의 음역 여부 / 양력일 경우 false


연간 운세 조회 결과 타입
키 값 설명
Content-Type Application/json JSON 포멧 String 데이터
연간 운세 조회 결과
키 타입 예제 설명
code 숫자(정수) 200 조회 결과 코드
message 문자열 "OK" 운세를 보고자 하는 날의 월
data JSON 
{
    "year01": {
      "title": "1월",
      "description": "한 번은.... 합니다."
    },
    "year02": {
      "title": "2월",
      "description": "어둡던 .... 필요합니다."
    },
    "year03": {
      "title": "3월",
      "description": "위 아래가 .... 필요합니다."
    },
    "year04": {
      "title": "4월",
      "description": "남의 .... 합니다."
    },
    "year05": {
      "title": "5월",
      "description": "여름 .... 좋습니다."
    },
    "year06": {
      "title": "6월",
      "description": "출행하면 .... 있습니다."
    },
    "year07": {
      "title": "7월",
      "description": "집에는 .... 있겠습니다."
    },
    "year08": {
      "title": "8월",
      "description": "만일 .... 좋겠습니다."
    },
    "year09": {
      "title": "9월",
      "description": "구월과 .... 합니다."
    },
    "year10": {
      "title": "10월",
      "description": "공을 .... 덕입니다."
    },
    "year11": {
      "title": "11월",
      "description": "동짓달과 .... 있음입니다."
    },
    "year12": {
      "title": "12월",
      "description": "구름이 .... 합니다."
    },
    "year13": {
      "title": "소망운",
      "description": "아는 .... 때입니다. "
    },
    "year14": {
      "title": "직장운",
      "description": "직장 .... 없습니다."
    },
    "year15": {
      "title": "건강운",
      "description": "호사다마라는 .... 합니다. "
    },
    "year16": {
      "title": "연애운",
      "description": "오래 .... 됩니다. "
    },
    "year17": {
      "title": "총운",
      "description": "일지화조 .... 것입니다. "
    }
}
 운세 조회 결과 입니다.

연간 운세 조회 샘플 코드

테스트용 키 : 943156c8f56a4c88fad1ba1379e3bf00

샘플코드에 제공된 KEY는 테스트용으로 발급된 키 입니다. 실제로 조회된 운세 정보가 아니며, 파라미터 확인용으로만 사용 됩니다. 실제 운영시에는 필이 운영용 key를 별도로 발급받아서 사용 해주세요.

CURL

$ curl -G -L -d "targetYear=2016&birthYear=1984&birthMonth=5&birthDay=25&birthHour=17&isLunar=false&api-key=943156c8f56a4c88fad1ba1379e3bf00" "https://api.un7.kr/api/v1/year"
PHP
<?php
$param = array(
    'api-key' => '943156c8f56a4c88fad1ba1379e3bf00',    //API KEY
    'targetYear' => 2016,                               //운세를 보고자 하는 날의 년
    'birthYear' => 1980,                                //생년
    'birthMonth' => 11,                                 //생월
    'birthDay' => 9,                                    //생일
    'birthHour' => 11,                                  //생시
    'isLunar' => 'false',                               //음력 여부, 양력이면 false로 주세요
                                                        //값을 String 형태로 주는걸 잊지 마세요
);

$data = http_build_query($param);

$url = 'https://api.un7.kr/api/v1/year';
$timeout = 5;   //timout을 5초로 한다.

$ch = curl_init();
curl_setopt($ch,CURLOPT_URL,$url."?".$data);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_TIMEOUT, 5);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

$output = curl_exec($ch);

curl_close($ch);

//JSON 형태의 결과를 Array로 변환한다.
$fortune_result = json_decode($output,true);

//결과를 출력한다.
print_r($fortune_result);
?>
JAVA
String url = "https://api.un7.kr/api/v1/year";

String queryString = "targetYear={TARGET_YEAR}"
                    + "&birthYear={BIRTH_YEAR}&birthMonth={BIRTH_MONTH}&birthDay={BIRTH_DAY}&birthHour={BIRTH_HOUR}"
                    + "&isLunar={IS_LUNAR}"
                    + "&api-key={API_KEY}";
queryString = queryString.replace("{API_KEY}", "943156c8f56a4c88fad1ba1379e3bf00"); //API KEY
queryString = queryString.replace("{TARGET_YEAR}", "2016");          //운세를 보고자 하는 날의 년
queryString = queryString.replace("{BIRTH_YEAR}", "1980");			 //생년
queryString = queryString.replace("{BIRTH_MONTH}", "6");			 //생월
queryString = queryString.replace("{BIRTH_DAY}", "30");				 //생일
queryString = queryString.replace("{BIRTH_HOUR}", "12");			 //생시
queryString = queryString.replace("{IS_LUNAR}", "false");			 //음력 여부, 양력이면 false로 주세요.

URL obj = new URL(url + "?" + queryString);
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
con.setConnectTimeout(5000);
con.setReadTimeout(5000);

BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));

String inputLine;
StringBuffer response = new StringBuffer();

while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();

System.out.println(response.toString());

평생 운세 조회하기

요청 타입
키 값 설명
Content-Type Application/x-www-form-urlencode html form에 method 를 GET으로 설정한거에요
평생 운세 요청 파라미터
키 예제 설명
birthYear 1991 운세를 보고자 하는 사람의 생년
birthMonth 11 운세를 보고자 하는 사람의 생월
birthDay 23 운세를 보고자 하는 사람의 생일
birthDay 23 운세를 보고자 하는 사람의 생시(24시간)
isLunar false 생일의 음역 여부 / 양력일 경우 false


평생 운세 조회 결과 타입
키 값 설명
Content-Type Application/json JSON 포멧 String 데이터
평생 운세 조회 결과
키 타입 예제 설명
code 숫자(정수) 200 조회 결과 코드
message 문자열 "OK" 조회 결과에 대한 상태
data JSON 
"data": {
	"life01": {
		"title": "행운의 장소",
		"description": "십이지지의 .... 되겠습니다. "
	},
	"life02": {
		"title": "초년운",
		"description": "일찍 .... 여유파입니다. "
	},
	"life03": {
		"title": "중년운",
		"description": "생각이 .... 되겠습니다. "
	},
	"life04": {
		"title": "말년운",
		"description": "자태가 ..... 압니다. "
	},
	"life05": {
		"title": "성격운",
		"description": "열기보다 ....  가졌습니다. "
	},
	"life06": {
		"title": "적성운",
		"description": "훌륭한 .... 있습니다."
	},
	"life07": {
		"title": "직업운",
		"description": "솜씨가 .... 됩니다."
	},
	"life08": {
		"title": "건강운",
		"description": "활동력이 .... 체질입니다. "
	},
	"life09": {
		"title": "주택운",
		"description": "선천적인 ... 형성합니다. "
	},
	"life10": {
		"title": "연애운",
		"summary": "천사같은 .... 만남입니다. ",
		"maleDescription": "대체적으로 .... 합니다. ",
		"femaleDescription": "대체적으로 .... 좋겠습니다. "
	},
	"life11": {
		"title": "섹스운",
		"summary": "신성불가침의 .... 쌓습니다. ",
		"maleDescription": "컨디션에 .... 많습니다.",
		"femaleDescription": "컨디션에 .... 있겠습니다. "
	},
	"life12": {
		"title": "어울리는 궁합",
		"description": "영원히 .... 시기입니다. ",
		"summary": "일상생활 .... 합니다. "
	},
	"life13": {
		"title": "부부궁",
		"summary": "개성이 .... 행복합니다. ",
		"maleDescription": "사랑은 .... 있습니다. ",
		"femaleDescription": "사랑은 .... 것입니다. "
	},
	"life14": {
		"title": "금전운",
		"description": "돈관리는 .... 있겠습니다. ",
		"summary": "프라이버시를 .... 합니다. "
	},
	"life15": {
		"title": "행운",
		"description": "달빛을 .... 것입니다. ",
		"summary": "민첩한 .... 합니다. "
	},
	"life16": {
		"title": "팔복궁",
		"description": "뭐든지 .... 합니다. ",
		"summary": "행운을 .... 거뜬합니다. "
	},
	"life17": {
		"title": "별자리",
		"description": "9월 .... 가졌습니다. ",
		"summary": "12월 .... 인내합니다. "
	},
	"life18": {
		"title": "천생연분",
		"description": "뱀해 .... 안됩니다. "
	},
	"life19": {
		"title": "총평",
		"description": "눈물이 .... 뛰어납니다. "
	},
	"life20": {
		"title": "건강운",
		"description": "바위를 .... 있습니다."
	},
	"life21": {
		"title": "선천성격운",
		"description": "매사에 .... 있겠습니다. "
	},
	"life22": {
		"title": "직업운",
		"description": "사주에 .... 있습니다. "
	},
	"life23": {
		"title": "부부애정운",
		"description": "용모가 .... 있겠습니다. "
	},
	"life24": {
		"title": "육친운",
		"description": "당신의 .... 합니다. "
	},
	"life25": {
		"title": "직업운",
		"description": "금융 .... 어울립니다. "
	},
	"life26": {
		"title": "성격운",
		"description": "센스와 .... 것입니다. "
	},
	"life27": {
		"title": "애정운",
		"description": "자기표현이 .... 있겠습니다. "
	},
	"life28": {
		"title": "건강운",
		"description": "대체적으로 .... 좋겠습니다."
	},
	"life29": {
		"title": "오행으로 보는 총평",
		"description": "금성(金星)의 .... 없습니다. "
	},
	"life30": {
		"title": "오행으로 보는 사회적특성",
		"description": "모든 .... 때문입니다. "
	},
	"life31": {
		"title": "기호적인특성",
		"description": "달 .... 있겠습니다. "
	},
	"life32": {
		"title": "성격적인특성",
		"description": "천간의 .... 있습니다. "
	},
	"life33": {
		"title": "애정운의특성",
		"maleDescription": "무일생 .... 것입니다. ",
		"femaleDescription": "무일생 .... 있습니다. "
	},
	"life34": {
		"title": "재물운의특성",
		"description": "흙과 .... 됩니다. "
	},
	"life35": {
		"title": "신체적인특성",
		"description": "위장 .... 있습니다. "
	},
	"life36": {
		"title": "직업과명예",
		"description": "장면 .... 잘 맞습니다. "
	},
	"life37": {
		"title": "기질상의특성",
		"maleDescription": "성실하고 .... 습니다. ",
		"femaleDescription": "대개 .... 것입니다. "
	},
	"life38": {
		"title": "대길흉이 오는시기",
		"description": "이 세운이 .... 길합니다. "
	},
	"life39": {
		"title": "입시운",
		"description": "오행의 .... 있겠습니다."
	},
	"life40": {
		"title": "유학운",
		"description": "당신의 .... 있겠습니다."
	},
	"life41": {
		"title": "결혼후 부부운",
		"description": "신혼이 .... 방법이겠습니다."
	},
	"life42": {
		"title": "배우자의 바람끼",
		"description": "상대방은 .... 것입니다."
	},
	"life43": {
		"title": "미래배우자 얼굴",
		"maleDescription": "관상학적으로 .... 타입입니다. ",
		"femaleDescription": "둥그스름한 .... 있습니다. "
	},
	"life44": {
		"title": "미래배우자 성격",
		"maleDescription": "겉으로는 .... 사람입니다. ",
		"femaleDescription": "털털함의 .... 없습니다. "
	},
	"life45": {
		"title": "미래배우자 직업",
		"maleDescription": "전반적으로 .... 맞겠습니다. ",
		"femaleDescription": "서비스 .... 많습니다. "
	},
	"life46": {
		"title": "미래배우자와의 연애요령",
		"maleDescription": "초반에는 .... 되겠습니다. ",
		"femaleDescription": "바빠서 .. 니다. "
	}
}
운세 조회 결과 입니다.

평생 운세 조회 샘플 코드

테스트용 키 : 943156c8f56a4c88fad1ba1379e3bf00

샘플코드에 제공된 KEY는 테스트용으로 발급된 키 입니다. 실제로 조회된 운세 정보가 아니며, 파라미터 확인용으로만 사용 됩니다. 실제 운영시에는 필이 운영용 key를 별도로 발급받아서 사용 해주세요.

CURL

$ curl -G -L -d "birthYear=1984&birthMonth=5&birthDay=25&birthHour=17&isLunar=false&api-key=943156c8f56a4c88fad1ba1379e3bf00" "https://api.un7.kr/api/v1/year"
PHP
<?php
$param = array(
    'api-key' => '943156c8f56a4c88fad1ba1379e3bf00',    //API KEY
    'birthYear' => 1980,                                //생년
    'birthMonth' => 11,                                 //생월
    'birthDay' => 9,                                    //생일
    'birthHour' => 11,                                  //생시
    'isLunar' => 'false',                               //음력 여부, 양력이면 false로 주세요
                                                        //값을 String 형태로 주는걸 잊지 마세요
);

$data = http_build_query($param);

$url = 'https://api.un7.kr/api/v1/life';
$timeout = 5;   //timout을 5초로 한다.

$ch = curl_init();
curl_setopt($ch,CURLOPT_URL,$url."?".$data);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_TIMEOUT, 5);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

$output = curl_exec($ch);

curl_close($ch);

//JSON 형태의 결과를 Array로 변환한다.
$fortune_result = json_decode($output,true);

//결과를 출력한다.
print_r($fortune_result);
?>
JAVA
String url = "https://api.un7.kr/api/v1/life";

String queryString = "birthYear={BIRTH_YEAR}&birthMonth={BIRTH_MONTH}&birthDay={BIRTH_DAY}&birthHour={BIRTH_HOUR}"
                    + "&isLunar={IS_LUNAR}"
                    + "&api-key={API_KEY}";
queryString = queryString.replace("{API_KEY}", "943156c8f56a4c88fad1ba1379e3bf00"); //API KEY
queryString = queryString.replace("{BIRTH_YEAR}", "1980");			 //생년
queryString = queryString.replace("{BIRTH_MONTH}", "6");			 //생월
queryString = queryString.replace("{BIRTH_DAY}", "30");				 //생일
queryString = queryString.replace("{BIRTH_HOUR}", "12");			 //생시
queryString = queryString.replace("{IS_LUNAR}", "false");			 //음력 여부, 양력이면 false로 주세요.

URL obj = new URL(url + "?" + queryString);
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
con.setConnectTimeout(5000);
con.setReadTimeout(5000);

BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));

String inputLine;
StringBuffer response = new StringBuffer();

while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();

System.out.println(response.toString());

UN7 API - 개발자를 위한 운세 API 제공 서비스 입니다.

   실 서비스에 적용 하고 싶으세요 ?

실 서비스를 이용하기 위해서는 서비스 가입과 API 발급이 필요합니다. 운칠 서비스 담당자에게 문의 하시면, 서비스 가입부터 어드민 환경까지 구축 해드립니다.

서비스 가입/기타 문의 메일 : admin@un7.kr


   API 사용에 어려움이 있으신가요 ?

저희 서비스에 대해서 누구보다 잘 알고 있는 소프트웨어 엔지니어들이 궁금증을 해결해드립니다. 비용은 물론 없습니다.

기술 관련 메일 : tech@un7.kr

Designed with by Xiaoying Riley for developers