일반 규칙

  • REST API는 기본 URL 아래에서 사용할 수 있습니다:

/public/external/api

  • 모든 요청은 POST를 통해 보내야 합니다.
  • REST API는 HTTPS를 통한 요청만 지원합니다.
  • 요청에는 다음 헤더가 포함되어야 합니다:
편집

헤더 이름



헤더 값



설명



콘텐츠 유형



application/json



고정



auth



123…xyz



“API 액세스” 탭의 API 키



서명



Base64로 인코딩된 서명



를 사용하여 생성된 페이로드의 서명


“API 액세스” 탭에서 개인 키를 입력합니다.


  • 요청 본문은 다음 값을 포함해야 하는 json 인코딩된 객체여야 합니다:
편집

필드



필드 예제 값



설명



api



V2/장치/목록장치



API 이름



시간



1529662725



클라이언트 컴퓨터의 유닉스 타임스탬프(UTC).


허용되는 최대 시차


클라이언트와 서버 사이의 비율은 30


분.


  • 성공하면 API는 요청된 데이터(아래 쿼리 참조)와 HTTP 상태 코드 200을 반환합니다.
  • 오류가 발생하면 HTTP 상태 코드는 오류에 따라 4xx에서 5xx 사이가 되며 응답 객체에는 사람이 읽을 수 있는 오류 메시지 목록이 포함된 “errors” 키가 있는 배열이 포함됩니다.
  • 장치에 일치하는 데이터가 없는 경우 빈 배열이 반환됩니다.
  • 디바이스 ID가 존재하지 않으면 반환 데이터는 null이 됩니다.
This site is registered on wpml.org as a development site. Switch to a production site key to remove this banner.