Originally Published on my blog

가장 많이 사용되는 API 클라이언트 도구 중 하나인 Postman으로 응답을 보내고 볼 수 있습니다.
개발 환경에서. 그러나 Postman은 독점 소프트웨어이므로
무료 + 오픈 소스 대안이 있으므로 무언가를 찾아보겠습니다
불면증이나 우편 배달부처럼.

그러나 CLI가 있고 cURL이 다음 중 하나인 경우 CLI로 이동합니다.
사용하기 쉽고 모든 기능을 갖춘 도구이며 이 기사에서는 방법을 보여 드리겠습니다.
cURL + vim + git을 사용하여 잘 문서화된 API를 설정합니다.

vim 편집기에서 CLI를 실행하는 방법은 무엇입니까?

vim은 매우 강력한 편집기이며 명령줄을 실행할 수 있습니다.
그 안에. 명령 모드로 이동하여 삽입:! <command>하고 Enter 키를 누릅니다.

예를 들어:

  :! ls

ls 명령줄을 실행하고 내용을 표시합니다.
호출기에서.

현재 파일의 내용을 CLI로 실행합니다.

vim에서 빈 파일을 열고 그 안에 작성하고echo Hello, World! 저장합니다.
그런 다음 :!sh %를 씁니다.

퍼센트%는 파일명을 의미하므로 일반뱅으로 실행하면:! %내부 콘텐츠가 아닌 실행 파일로 파일을 실행하려고 하기 때문에 작동하지 않습니다.

그래서 sh 앞에 %를 전달하여 셸을 통해 파일 내부의 콘텐츠를 실행합니다.

첫 번째 cURL 명령 테스트

시연을 위해 jsonplaceholder을 API로 사용하여 테스트할 것입니다.

아래와 같이 폴더 구조를 만듭니다.

└── api
    └── todos
        ├── delete
        │   └── todo.zsh
        ├── get
        │   ├── todo-by-user.sh
        │   ├── todo.sh
        │   └── todos.sh
        ├── patch
        │   └── todo.sh
        ├── post
        │   └── todo.sh
        └── put
            └── todo.sh

.sh 파일을 강조 표시합니다.

첫 번째 간단한 것api/posts/get/todos.sh부터 시작하겠습니다.

파일에 쓰고 저장합니다.

curl -s -X GET \
    'https://jsonplaceholder.typicode.com/todos'

그런 다음 실행하기 전에 했던 것처럼 :!sh %

결과를 더 편리하게 만드십시오.

대부분의 도구에서 요청 자체에 대한 분할 보기를 얻을 수 있습니다.
그리고 그 결과.

vim 구성 파일을 열고 추가하십시오.

command Exec set splitright | vnew | set filetype=sh | read !sh #

이전 명령은 수직 보기에서 새 버퍼의 결과를 엽니다.

수평 보기를 선호하는 경우 명령을 다음으로 변경할 수 있습니다.

command Exec set splitbelow | new | set filetype=sh | read !sh #

다시 열고api/posts/get/todos.sh 명령 모드에서 쓰기:Exec파일 내에서 명령을 실행하고 결과로 분할 보기를 엽니다.



이제 당신은 당신이 무엇을 하든지 쉽게 검색하고 할 수 있는 vim 버퍼가 있습니다. 버퍼를 닫으려면 다음을 사용할 수 있습니다.
명령:bd! 또는 키보드 단축키shift + z + q .

cURL이 제한되어 있습니까?

내 대답은 아니오 야.
몇 가지 예를 보자

POST 요청:

curl -s -X POST \
    'https://jsonplaceholder.typicode.com/posts' \
    -H 'Content-Type: application/json' \
    -d '{ "title": "fooBatch", "completed": false, "userId": 1 }' \

-X <REQUEST_TYPE> 옵션을 사용하여 게시, 가져오기, 넣기, .. 또는 모든 http 요청을 만들 수 있습니다.

본문 데이터를 전달하려면 -d, --data {json format>}를 사용하고 데이터가 큰 경우json 파일에 작성하고 -d @todo.json로 전달할 수 있습니다.

쿼리 매개변수가 있는 GET 요청:

curl -s -X GET -G \
    'https://jsonplaceholder.typicode.com/todos' \
    -d 'userId=1'

-d와 함께 쿼리 매개변수를 계속 사용할 수 있지만 추가-G, --get를 추가하여 쿼리 매개변수로 전달할 수 있습니다.

이것은 cURL 튜토리얼이 아니기 때문에 충분할 것입니다.
인터넷에서 설정 헤더, 쿠키 등과 같은 고급 항목에 대해 자세히 알아볼 수 있습니다.

자식을 사용합니까?

물론 생성된 디렉토리에서 git init를 실행하고 예를 들어 github에 푸시합니다.

see this example on github

결론

이제 잘 문서화된 API를 작성하고 git을 통해 친구들과 공유할 수 있습니다.
단순하고 오픈 소스 도구로 수행되며 cURL에 국한되지 않습니다.
당신은 자신의 스크립트를 작성하고 vim 내에서 실행하거나 anther를 위해 cURL 명령을 파이프할 수 있습니다.
예를 들어 출력을 조작하는 도구jq를 사용하여 출력을 필터링할 수 있습니다.