@api

• 외부의 API를 요청할 때 사용해요.

• 앱을 만들 때 외부의 서비스 사용이 필요할 수 있어요.

• 외부의 서비스가 API 방식을 제공할 때 해당 API를 로직에서 호출하여 사용할 수 있어요.

ex) 날씨 API 에서 제공하는 날씨 정보를 앱에 저장시킬 때, 축구 API 를 이용하여 경기의 결과를 정기적으로 수집하여 앱에서 보여줄 때 등.

사용 방법

1. 로직 설정 ➡︎ If When, Where에 원하는 값 입력 ➡︎ New data query 를 펼쳐 주세요.

2. Event에서 @api를 드래그앤드롭하여 원하는 위치(flows, #ifTrue, #ifFalse, @for)에 넣어주세요.

3. 아래의 이미지와 같이 #url, #parameter, #type, #header, #setResponse에 필요한 값을 작성해 주세요.

필드 설명

• #url (String, 동적 키, 동적 Object) => (최종형 String) (필수)

  • 호출할 API의 URL주소를 작성해요.

• #parameter (Object, 동적 키, 동적 Object) (최종형 Object) (선택)

  • url을 호출할 때 사용할 파라미터 설정할 수 있어요.

  • 모든 데이터형이 사용할 수 있어요.

• #type(String) (필수)

  • API의 타입을 설정해요.

  • 지금은 method가 post인 “documentParameterPost”만 지원하고 있어요.

• #header(Object, 동적 키, 동적 Object) => (최종형 Object) (선택)

  • API를 호출할 때 필요한 헤더의 설정 정보를 작성해요.

• #setResponse( (String, 동적 키, 동적 Object) => (최종형 String) (필수)

  • API를 요청하고 받은 값(response 값) 이 저장될 tmpDocument의 key를 작성해요.

2024.03.11 Jinny