디자인하는 방법 REStful API 를 위한 엔진의 미디어 분석

Question

나는 새로운 편안한 개념과 디자인을 위한 간단한 API 미디어 분석 서비스를 설정해야합니다,다양한 작업을 수행,예를 들어,얼굴 분석,지역 detection,등등.에 업로드한 이미지 및 비디오입니다.

개략 내 초기 디자인은 다음과 같습니다:

• 클라이언트는 게시물 구성 XML 파일 http://manalysis.com/facerecognition.이 프로필 을 위해 사용될 수 있는 여러 분석 세션이 있습니다.응답 XML 포함 ProfileID 을 참조하다.클라이언트에 건너 뛸 수 있습니다 이 단계에 사용하는 기본 구성 매개변수
• 클라이언트는 게시물에 비디오 데이터를 분석하는 http://manalysis.com/facerecognition (가 Id 매개 변수로 설정한 경우).이 분석 세션.XML 을 반환하는 SessionID.
• 클라이언트를 보낼 수 있습을 얻 http://manalysis.com/facerecognition/SessionID 을 받을 세션 상태입니다.

내가 오른쪽에는 트랙?특히,나는 다음과 같은 질문:

• 해야가 포함됩 facerecognition URL?로이 필딩 말하는"REST API 를 정의하지 않아야 합 고정 자원의 이름 또는 계층"이 인스턴스에는 실수를 했을까요?
• 분석 결과될 수 있습 반환 클라이언트 중 하나에서 큰 XML 파일이나 이벤트 감지합니다.어떻게 내가 말해야 하는 분석 엔진 곳에 결과를 반환?
• 해야 하는 명시적으로 삭제될 때 프로파일 분석 수행을 통해,삭제 전화?

감사합니다,

C

Answer 1

당신이 해결할 수 있습니다 입국 지점에 url 을,

GET /facerecognition

<FaceRecognitionService>
  <Profiles href="/facerecognition/profiles"/>
  <AnalysisRequests href="/facerecognition/analysisrequests"/>
</FaceRecognitionService>

새 프로필을 만들에 게시하여 XML 프로파일은 URL 을 href 특성의 요소 프로파일

POST /facerecognition/profiles
201 - Created
Location: /facerecognition/profile/33

분석을 시작하여 새로 만드 분석 요청을 합니다.내가 피를 사용하는 용어의 세션으로 그것은 너무 일반적이고 부정적인 연결의 나머지 부분에서 세계입니다.

POST /facerecognition/analysisrequests?profileId=33
201 - Created
Location: /facerecognition/analysisrequest/2103

의 상태를 확인하는 프로세스

GET /facerecognition/analysisrequest/2103

<AnalysisRequest>
   <Status>Processing</Status>
   <Cancel Method="DELETE" href="/facerecognition/analysisrequest/2103" />
</AnalysisRequest>

면 처리가 완료되면,같은이 얻을 반환 할 수 있습니다

<AnalysisRequest>
   <Status>Completed</Status>
   <Results href="/facerecognition/analysisrequest/2103/results" />
</AnalysisRequest>

특정 Url 을 선택했는 상대적으로 임의,뭐든지 사용할 수 있는 가장 깨끗한다.