Web Api 기능 문의
0. SDK Version: 4.1
0. 안드로이드 스튜디오
0. 이미지 타겟
0. License Type(Pro):
클라우드 Web API를 이용하는 데 있어서 몇가 문의 드립니다.
1. Web API를 이용하여 사이트를 접속하지 않고 이미지 업로드가 가능한 프로그램을 만들려고 하는데 가능한가요?
2. Web API 접속 테스트를 해보려고 합니다.
URL에 https://developer.maxst.com/api/Trackables/ 를 입력 후 Header 에 Authorization입력 후 Value 값을 JWT 에서 나온 코드값을 입력하면 되나요? 자세한 방법에 대해 알고싶습니다.
1. 네 가능합니다. Web API를 사용하시면 됩니다.
https://developer.maxst.com/MD/doc/4_1_x/cloud/webapi 페이지를 참조해주세요.
2. Web API 간단한 사용법을 알려드리겠습니다.
2-1. https://jwt.io/를 접속하여 토큰을 생성할 수 있습니다.
2-2. body부분(PAYLOAD)에는 iat와 secId를 입력해줍니다. iat는 UTC시간을 입력하면 됩니다.
secId는 클라우드에 생성하신 폴더에 들어가시면
우측상단에 엑세스 키 버튼을 눌러 확인할 수 있습니다.
https://developer.maxst.com/TrackableGroupCls 해당 페이지에서 확인하실 수 있습니다.
2-3. 이어서 VERIFY SIGNATURE에 sec_key를 입력해줍니다. 그리고 좌측에 생성된 코드가 인증 키입니다.
2-4. Web API를 사용할 프로그램을 사용하여 인증 키와 같이 보내줍니다.
저는 Fiddler라는 프로그램을 사용하여 GET 방식을 선택 후
Web API 목록중에 타겟 그룹 정보를 얻어보았습니다.
https://developer.maxst.com/api/TrackableGroupInfo의 주소에 위에 생성한 인증 키를 같이 보내면
HOST에서 현재 타겟 그룹에 대한 정보를 보내줍니다.
2.5 위와 같은 방법으로 Web API를 통해 이미지 업로드를 하려면
Web API 페이지의 Create Target 내용을 보고 인증키, 컨텐츠 타입, Body에 필요한 정보들을 기입하여
POST 하시면 사이트에 접속하지 않고도 이미지 등록이 가능합니다.
감사합니다.
2번 질문에 이어서 질문 드립니다.
Delete 기능 사용할 시 ID 입력이 있는데 이 아이디는 GET 하였을 시 출력되는 아이디를 입력하면 되는 것인가요?
네 맞습니다. 어떤 이미지 타겟을 삭제할지 이미지에 대한 ID를 전달해주어야하니까요.
Leo
Maxst Support Team
많은 질문 드려 죄송한데 하나만 더 여쭤보겠습니다. 위에 이미지 처럼 구현 할려고 하는데 maxst에서 지원해주는 Web API로 가능한가요? 여러 사진을 많이 등록하여 인식하려고 하고 있습니다. (예: 건물 사진 ) 다르게 가능 한 방법이 있다면 알고싶습니다.
이미지 등록은 MAXST 클라우드 서버에 되고,
이미지 트래킹은 클라우드 서버에 등록된 이미지를 통해 가능한데
굳이 그 사이에 개인 서버를 하나 더 두는 이유는 무엇인가요?
Leo
Maxst Support Team
개인이 사용하지 않고 여러 사용자들에게 배포하고 관리를 하려고 합니다.
그렇게 되면 사용한계가 있을 것으로 예상되어 서버를 사용하려고 합니다.
Get API로 이미지 다운로드가 가능할까요?
결론부터 말씀드리자면 불가능합니다.
서버가 끼면 설명이 헷갈릴 수 있으니 서버없이 간략하게 개인-클라우드 서버의 상황으로 보겠습니다.
개인 사용자 입장에서 볼 때 클라우드 서버에 이미지를 등록할때는 개인한테 이미 원본 이미지가 있습니다.
서버측에서는 이미 유저가 원본 이미지를 가지고 있다는 가정하에 이미지 다운로드를 제공하지 않습니다.
서버에서 이미지 다운로드를 제공하는것도 서버에 부하가 걸리고,
이미지 다운로드가 가능하면 서버를 이미지 게시판 용도로 사용하는것도 가능하기 때문에 애초에 제공을 하지 않습니다.
서버에서 제공하는 것은 추적할 이미지에 대한 학습된 맵 형식인 2dmap 파일로 제공합니다.
또한, 위에 올려주신 이미지도 조금 잘못된것 같습니다.
유저가 개인 서버에 이미지 등록을 하고 개인 서버에서 클라우드 서버에 이미지를 등록하는 것까지는 가능합니다.
개인 서버가 고객 관리 차원에서 고객들이 추적할 이미지 원본들을 저장하는 용도에서요.
그러나 저희 2dmap 파일을 제공받아 이미지 트래킹을 하는 과정에서는 개인 서버를 거치지 않습니다.
클라우드 추적기는 다이렉트로 저희 클라우드 서버와 붙습니다. url이 코드에 박혀있기 때문입니다.
도움이 되었길 바랍니다.
감사합니다.
Leo
Maxst Support Team