Getting Started
Flow OpenAPIInformation
Flow Open API center를 사용하면 실제 구현 로직 없이도 API의 리소스와 상호 작용할 수
있습니다.
Flow가 제공하는 서비스를 살펴보고 API요청을 테스트 할 수 있습니다.
모든 API 내부의 Test탭에 접근해서 Request 설정을 완료하고 API를 호출하여 결과를 얻을 수 있습니다.
Flow Open API를 구현하기 전에 요청 매개 변수를 탐색하고 응답을 확인하면 시간과 노력을 크게 절약할
수 있습니다.
Tutorial
Flow에서 제공하는 API를 사용하기 위해서 다음과 같은 과정을 따라야 합니다.
1. 테스트하고자 하는 API를 선택합니다.
2. Request 탭에서 필요한 데이터를 확인합니다.
3. 각 API별 Test 탭에서 테스트를 진행합니다.
4. 테스트 탭에서 출력된 응답을 Response 탭의 예시 데이터와 비교해서 확인합니다.
5. API를 사용자의 실제 프로젝트에 적용합니다.
* 조회를 제외한 API 호출은 분당 최대 60회로 제한되어 있습니다. (조회는 분당 최대 100회
제한)
제공 API
사용자 인증
키관리 페이지에서 발급받은 API Key를 이용해 API 요청을 인증할 수 있습니다.
API Key 값은 모든 API 요청 시, 필수로 포함되어야 합니다.
이에 대한 자세한 설명은 각 Request, Codesnippet 탭에 설명되어 있습니다.
API
(Application Programming Interface)API는 응용 프로그램 간에 통신하기 위한 규약 또는 인터페이스를 의미합니다.
소프트웨어 개발자들이 서로 다른 시스템 또는 애플리케이션 간에 데이터를 교환하고 상호작용하기
위해 사용됩니다.
API는 일련의 기능, 프로토콜, 도구, 클래스 등으로 구성됩니다.
다른 개발자들이 해당 API를사용하여 애플리케이션 또는 서비스의 기능을 확장하거나 특정 기능을
이용할 수 있게 해줍니다.
HTTP
(Hypertext Transfer Protocol)HTTP는 웹 서버와 클라이언트 간에 데이터를 전송하는 프로토콜입니다.
웹 브라우저가
서버로부터 웹 페이지를 요청하고, 서버는 요청된 데이터를 응답으로 전송합니다.
HTTP는
주로 HTML 문서, 이미지, 동영상, 파일 등을 전송하는 데 사용됩니다.
HTTP는 요청
메서드(GET, POST, PUT, DELETE 등), 상태 코드(200, 404, 500 등), 헤더, 본문(body) 등으로
구성됩니다.
개발자들은 HTTP를 사용하여 서로 다른 애플리케이션 간에 데이터를 주고받을
수 있습니다.
HTTP Method
GET
GET은 서버로부터 리소스를 가져오기 위해 사용되는 메서드입니다.
클라이언트는 GET
요청을 보내어 서버로부터 데이터를 요청하고, 서버는 해당 데이터를 응답으로 반환합니다.
GET은 주로 데이터를 조회하는 데 사용되며, 요청의 본문(body)에 데이터를 담지 않습니다.
POST
POST는 서버에 새로운 데이터를 생성하기 위해 사용되는 메서드입니다.
클라이언트는
POST 요청을 보내어 서버로 데이터를 전송하고, 서버는 해당 데이터를 처리하여 새로운
리소스를 생성합니다.
POST는 주로 데이터를 제출하거나 서버에 상태 변화를 일으키는
데 사용됩니다.
PUT
PUT은 서버에 새로운 데이터를 생성하거나 기존 데이터를 업데이트하기 위해 사용되는
메서드입니다.
클라이언트는 PUT 요청을 보내어 서버로 데이터를 전송하고, 서버는
해당 데이터를 지정된 위치에 저장하거나 업데이트합니다.
PUT은 주로 데이터의 전체 내용을
업데이트하는 데 사용됩니다.
PATCH
PATCH는 서버에서 기존 데이터의 일부를 업데이트하기 위해 사용되는 메서드입니다.
클라이언트는 PATCH 요청을 보내어 서버로 업데이트할 데이터를 전송하고, 서버는 해당 데이터를
사용하여 기존 데이터의 일부를 업데이트합니다.
PATCH는 데이터의 부분적인 수정 또는
변경을 위해 사용됩니다.
DELETE
DELETE는 서버에서 특정 리소스를 삭제하기 위해 사용되는 메서드입니다.
클라이언트는 DELETE 요청을 보내어 서버로 특정 리소스의 삭제를 요청하고, 서버는 해당 리소스를
삭제합니다.
DELETE는 데이터의 삭제를 의도적으로 수행하는 데 사용됩니다.
JSON
(JavaScript Object Notation)JSON은 데이터 교환을 위한 경량의 데이터 형식입니다.
텍스트 형식으로 구성되며, 사람과
기계 모두 이해하기 쉽습니다.
JSON은 속성-값 쌍으로 이루어진 데이터 객체를 표현하는
데 사용됩니다.
주로 웹 애플리케이션에서 데이터를 전송하고 저장하는 데에 널리
사용되며, API에서도 데이터를 교환하기 위한 표준 형식으로 많이 사용됩니다.
JSON은
다양한 프로그래밍 언어에서 지원되고, 구조적이며 유연한 데이터 형식으로 인기가 있습니다.
JSON 값에 줄바꿈을 입력하고 싶으면 하단에 이스케이프 문자(escape character) 설명을 참고하시길
바랍니다.
1
|
|
2
|
|
3
|
|
4
|
|
5
|
|
6
|
|
Escape Character
단어나 문자열 안에서 특별한 의미를 갖는 문자를 표현하기 위해 사용되는 것이 "이스케이프
문자(escape character)"입니다.
이스케이프 문자는 백슬래시(\)와 함께 특정 문자
조합으로 구성됩니다.
주로 문자열 리터럴 안에서 사용되며, 특정 문자를 일반 문자로
해석하도록 도와줍니다.
주요한 이스케이프 문자들은 다음과 같습니다:
[ \ ]
역슬래시이스케이프 문자 자체를 문자로 나타내기 위해 사용됩니다.
예를 들어, "\\n"은 문자열
내에서 백슬래시를 출력하는 것이 아니라 줄바꿈 문자를 표현합니다.
[ ' ]
작은따옴표문자열이 작은따옴표로 둘러싸여 있을 때, 작은따옴표를 일반 문자로 사용하려면 \'로
이스케이프합니다.
예를 들어, 'It\'s raining'은 작은따옴표를 일반 문자로 해석하여
"It's raining"을 출력합니다.
[ " ]
큰따옴표문자열이 큰따옴표로 둘러싸여 있을 때, 큰따옴표를 일반 문자로 사용하려면 \"로
이스케이프합니다.
예를 들어, "She said, \"Hello!\""는 큰따옴표를 일반 문자로 해석하여
"She said, "Hello!""를 출력합니다.
[ \n ]
줄바꿈줄바꿈을 표현하기 위해 사용됩니다.
예를 들어, "Hello\nWorld"는 "Hello"와 "World"를
각각 새로운 줄에 출력합니다.
[ \t ]
탭탭 문자를 표현하기 위해 사용됩니다.
예를 들어, "Name:\tJohn"은 "Name:"과 "John" 사이에
탭 간격을 생성합니다.
Types
type :: String
String은 텍스트 데이터를 나타내는 데이터 타입입니다.
문자열은 따옴표(" ") 또는
작은따옴표(' ')로 감싸져 있으며, 예를 들면 "Hello, World!"와 같은 형태입니다.
문자열은 단일 문자 뿐만 아니라 여러 문자들을 포함할 수 있습니다.
예를 들어,
"OpenAI"는 6개의 문자로 이루어진 문자열입니다.
문자열은 주로 텍스트 데이터를 표현하고
다루는 데 사용됩니다.
type :: Number
Number는 숫자 데이터를 나타내는 데이터 타입입니다.
숫자는 정수나 실수 등의
형태를 가질 수 있습니다.
예를 들어, 10, 3.14, -5 등이 숫자 데이터입니다.
숫자는 계산이나 측정과 관련된 작업에 주로 사용됩니다.
예를 들어, 나이, 가격, 수량
등을 표현하기 위해 숫자 데이터를 사용할 수 있습니다.
type :: Boolean
Boolean은 참(True) 또는 거짓(False)의 값을 나타내는 데이터 타입입니다.
Boolean은
조건을 표현하거나 논리적인 판단을 나타내기 위해 사용됩니다.
예를 들어, "사용자가
로그인했는지?"라는 질문에 대한 답은 참(True) 또는 거짓(False)이 될 수 있습니다.
조건문에서
특정 조건이 참인지 아닌지를 판별하는 데 사용되며, 프로그램의 흐름을 제어하는 데에도 활용됩니다.
type :: Object
Object(객체)는 속성(key-value pair)과 메서드로 구성된 복합 데이터 타입입니다.
객체는 다양한 속성과 해당 속성에 대한 값들을 포함하고 있으며, 이를 통해 객체의 상태를 표현합니다.
또한 객체는 해당 속성과 관련된 동작을 수행하는 메서드를 포함할 수 있습니다.
예를 들어, 자동차 객체의 속성으로는 색상, 모델, 제조사가 있을 수 있고, 메서드로는 가속,
감속, 정지 등이 있을 수 있습니다.
객체는 개념적인 단위를 모델링하고 실제 세계를 반영하는
데 사용됩니다.
type :: Array
Array는 여러 값을 순차적으로 저장하는 데이터 구조입니다.
배열은 대괄호([ ])로
묶여 있으며, 쉼표로 구분된 값들의 목록을 포함합니다.
배열은 동일한 데이터 타입의
값 또는 여러 데이터 타입의 값들을 포함할 수 있습니다.
예를 들어, [1, 2, 3, 4,
5]는 1부터 5까지의 정수를 포함하는 배열입니다.
배열은 데이터를 그룹화하거나 여러
개체를 다루는 데 유용합니다.