POST/business-support/approval/users/{userId}/documents/create-document-link

외부에서 회사 생성 서식 문서 작성을 위한 팝업 URL을 생성한다.

주의

  • 생성된 URL로 팝업을 오픈하면 문서 작성 화면에 초기 데이터를 설정할 수 있다.
  • 생성된 URL은 10분간 유효하고 이후에는 접근할 수 없다.

Authorization

oauth2

OAuth 2.0 인증.
자세한 인증 방식은 인가·인증을 참고한다.

Scope

businessSupport.approval

HTTP Request

POSThttps://www.worksapis.com/v1.0/business-support/approval/users/{userId}/documents/create-document-link

Path Parameters

ParameterTypeDescription
userId string 

구성원 ID


required 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 
Content-Type string 

application/json


required 

Request Body

PropertyTypeDescription
title string 

제목


required
minLength : 1
maxLength : 200 
documentFormId string 

서식 ID


required 
documentBody array (DocumentBody) 

문서 작성 가이드(회사 생성 서식)를 참고한다.


required 

DocumentBody

PropertyTypeDescription
componentType string 

컴포넌트 유형


required 
componentId string 

컴포넌트 ID(컴포넌트 ID 또는 사용자 지정 ID 입력 가능)


required 
componentValue object 

컴포넌트값

 

Request Example

example

1{2  "title": "연차 사용 계획서",3  "documentFormId": "16d11974-7351-4cc9-9eec-52322ff286ee",4  "documentBody": [5    {6      "componentType": "CP_TEXT",7      "componentId": "f153b327-c66b-eb1d-bc69-6bdb187a6cc7",8      "componentValue": {9        "value": "홍길동"10      }11    }12  ]13}

Response

HTTP 201

OK

PropertyTypeDescription
authToken string 

API 성공 시 발급되는 키


required 
approvalDocumentUrl string 

팝업 URL


required 

Response Example

example

1{2  "authToken": "3d0af0a5-6a5b-4075-ae06-27e73df53ff9",3  "approvalDocumentUrl": "https://flow.worksmobile.com/user/write/fg-dfm/16d11974-7351-4cc9-9eec-52322ff286ee?companyId=e721e2da-29ee-4782-9672-3d2b150ac1a6&authToken=3d0af0a5-6a5b-4075-ae06-27e73df53ff9"4}

HTTP 403

Forbidden