> For the complete documentation index, see [llms.txt](https://happytalk.gitbook.io/happybot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://happytalk.gitbook.io/happybot/block_scenario/block/undefined/api.md).

# \[단일] API

***

## &#x20;1. ![](https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2FqVbqzjvvi1DehbgqxD9C%2Fimage.png?alt=media\&token=464e1577-2548-4440-b384-d32fb9e35ecd) 'API' 블럭이란?

{% hint style="success" %} <mark style="color:green;">**외부 API 통신 블럭으로, 별도의 설정이 추가로 필요한 블럭**</mark>입니다.<br>

**\[Success] \[Fail]** 버튼 2개만 제공되며,\
제공되는 기본 버튼은 모두 삭제 및 수정이 불가능합니다.
{% endhint %}

***

## 2. 블럭의 형태 및 사용 방법

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2FzrDHjhFvzAnU1GGiiEsv%2Fimage.png?alt=media&amp;token=421c3dad-4ca7-4e2a-b64f-c52cfdb2d5a3" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="80">No</th><th width="178">구분</th><th width="71">필수</th><th>설명</th></tr></thead><tbody><tr><td>①</td><td>블럭 타이틀</td><td>X</td><td><ul><li>40자 이하 입력/수정 가능 </li><li>생성 시 “<em>API {No}</em>” 형태로 생성 됨</li></ul></td></tr><tr><td>②</td><td>Success 버튼</td><td>O</td><td><ul><li>통신 성공 시 이동될 블럭/파라미터 설정 가능</li><li>버튼명 수정 불가</li></ul></td></tr><tr><td>③</td><td>Fail 버튼</td><td>O</td><td><ul><li></li><li>통신 성공 시 이동될 블럭/파라미터 설정 가능</li><li>버튼명 수정 불가</li></ul></td></tr><tr><td>④</td><td>블럭 간략 설정 버튼</td><td>-</td><td><ul><li>클릭 시 아래 액션이 가능한 버튼 레이어 노출 <br>a. 미리보기 <br>b. 복제하기 <br>c. 내용접기 <br>d. 블럭 저장 <br>e. 블럭 삭제</li></ul></td></tr></tbody></table>

***

## 3. 제공되는  버튼 기능

{% hint style="success" %} <mark style="color:green;">**API 블럭에서 지원 가능한 버튼의 기능은 총 2가지 입니다.**</mark>\
\
버튼에 변수 부여를 위한 파라미터 설정이 가능하며,

버튼 파라미터 부여 방법은 버튼 파라미터 설정에서 확인 가능하실 수 있습니다.<br>

[변수/파라미터 설정](/happybot/block_scenario/parameter.md)
{% endhint %}

<table><thead><tr><th width="240">버튼 기능</th><th>설명</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>블럭 연결</strong></td><td>다른 메시지 카드로 연결함</td><td></td></tr><tr><td><strong>시나리오 연결</strong></td><td>다른 시나리오의 시작점으로 연결함</td><td></td></tr></tbody></table>

***

## 4. API 상세 설정 레이어&#x20;

{% hint style="success" %}
API 상세 설정 레이어에서, 통신 관련 내용을 입력하고 API 테스트를 진행할 수 있습니다
{% endhint %}

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2F55WI7ApS1guPq9DNwCxV%2Fimage.png?alt=media&amp;token=88fa7adc-2a6a-4ed4-bae2-074606322d79" alt=""><figcaption></figcaption></figure>
