개발자 센터

키워드를 기반으로 좌표 가져오기

POST /esignglobal/v1/files/keywordPositions

인터페이스 설명

API를 사용하여 봉투를 시작하기 전에 이 인터페이스를 통해 파일에서 지정된 콘텐츠의 좌표를 가져와 봉투 시작 인터페이스의 입력 매개변수로 사용할 수 있습니다. 검색 범위는 전체 문서입니다.

요청 매개변수

매개변수 이름

유형

필수

설명

fileKey

string

true

파일 fileKey

keywords

array

true

키워드 목록, 이 값을 통해 파일의 위치 좌표를 찾을 수 있습니다.

【주의】

  1. 한 번에 최대 5개의 키워드를 전달할 수 있습니다.
  2. 키워드는 특수 문자, 이모티콘 등 Adobe에서 구문 분석할 수 없는 문자를 지원하지 않습니다.

요청 예시

{
    "keywords": [
    "制单人:",
    "打印日期:"
  ],
    "fileKey": "$dd863699-e1ba-47ba-b05c-26029e7089f9$793468458"
}

응답 매개변수

매개변수 이름

유형

설명

keywordPositions

array

키워드 정보

 

keyword

array

키워드

 

searchResult

boolean

키워드가 좌표값을 검색했는지 여부

 

 

positions

array

키워드 위치 정보

 

 

pageNum

int

키워드가 있는 페이지 번호

 

 

coordinates

array

키워드 XY 좌표값

【주의】 좌표 위치는 키워드의 첫 글자를 기준으로 위치를 정하며, 좌표 배열은 Y 좌표 내림차순, X 좌표 오름차순으로 정렬됩니다.

 

 

 

positionX

float

X좌표

 

 

 

positionY

float

Y좌표

응답 예시

{
    "code": "0",
    "data": [
    {
      "keyword": "制单人:",
      "positions": [
        {
          "coordinates": [
            {
              "positionX": 174,
              "positionY": 361.27
            }
          ],
          "pageNum": 2
        }
      ],
      "searchResult": true
    },
    {
      "keyword": "打印日期:",
      "positions": [
        {
          "coordinates": [
            {
              "positionX": 804,
              "positionY": 361.77
            }
          ],
          "pageNum": 2
        }
      ],
      "searchResult": true
    }
  ],
    "message": "成功"
}

 

인터페이스 설명
요청 매개변수
요청 예시
응답 매개변수
응답 예시