ePosition API

시작하기

아래의 사용안내에 따라 ePosition API를 사용하시기 바랍니다.

이포지션 아이디 주요특징
1. 이포지션 식별ID를 통한 체계적이고 논리적인 연동방식
2. URL 주소를 갖는 객체를 통합식별ID로 등록
3. 통합식별ID → URL → 정보 링크로 접속불량 최소화
4. 통합식별ID 미등록 객체는 기존의 URL로 직접 링크 호환성 확보
5. 통합식별ID 미등록 객체는 URL로 정보 접속
6. 기존의 방식으로 독립적인 운용 가능
요청 URL (Request URL)
URL METHOD 기능
http://egosio.com/v1/eposition?epid=[이포지션아이디]&answer=[xml, json] GET 정보요청
요청 변수 (Request Parameter)
요청 변수 설명
epid String (필수) 조회 할 이포지션 아이디를 입력합니다.
특수문자 “.”, “-” 은 가능하며 나머지는 허용안됨.
글자사이 여백 허용안됨.
길이제한 50자.
answer String (선택) 응답 형식[xml, json]을 입력합니다.(입력하지 않을경우 xml)
출력 결과 필드 (Response Field)

정보요청이 성공하면 응답 바디에 XML 또는 JSON 객체로 아래 값을 포함합니다.

설명 타입
status 상태 코드 String
epid 이포지션 아이디 String
open Open or Not Open(Open : True, Not Open : False) String
url url 정보 String
short_url short url String

예를 들면,

XML
<?xml version='1.0' encoding='UTF-8'?>
<eposition>
	<status>200</status>
	<epid>
		<![CDATA[starwars#egosio.com]]>
	</epid>
	<open>True</open>
	<url>
		<![CDATA[https://www.facebook.com/StarWars.kr]]>
	</url>
	<short_url>
		<![CDATA[http://egosio.com/iot/starwars]]>
	</short_url>
</eposition>
JSON
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
  "eposition": {
	"status": "200",
	"epid": "starwars#egosio.com",
	"open":"True",
	"url": "https://www.facebook.com/StarWars.kr",
	"short_url":"http://egosio.com/iot/starwars"
  }
}
에러 코드 (Error Code)

다음은 에러 코드에 대한 정의입니다.

status error_msg
200 인증성공
400 인증실패(이포지션아이디가 등록되어 있지 않거나 조회 실패)
600 이포지션 아이디 형식이 옳지 않습니다.
예를들면 (PHP, JSON)

다음은 예제 프로그램 입니다.


starwars#egosio.com 의 url 정보를 요청합니다.

<?php
define("EPOSITION_API_URL","http://egosio.com/v1/eposition");

// $epid = urlencode('starwars'); // 아이디로 요청할 경우 starwars
$epid = urlencode('starwars#egosio.com'); // 아이디와 등록서버주소를 포함할 경우 starwars#egosio.com

$api_url_json = EPOSITION_API_URL.'?epid='.$epid.'&answer=json';

$str = file_get_contents($api_url_json);
$json = json_decode($str, true);
//print_r($json);

if ($json['eposition']['status']=='200' && $json['eposition']['open'] == 'True') {
	echo $json['eposition']['url'];
	//echo $json['eposition']['epid'];
	//echo $json['eposition']['short_url'];
} else {
	echo $json['eposition']['open'];
}
?>
									

결과

https://www.facebook.com/StarWars.kr