Twurl은 컬과 비슷하지만 특히 Twitter API에 맞게 맞춤화되었습니다. 지정된 사용자에 대해 클라이언트 애플리케이션에 액세스 토큰을 부여한 다음 해당 액세스 토큰으로 모든 요청에 서명하는 방법을 알고 있습니다.
또한 일반적인 요청에 대한 별칭 정의와 같은 기타 개발 및 디버깅 편의성을 제공할 뿐만 아니라 여러 클라이언트 애플리케이션과 Twitter 계정 간에 쉽게 전환할 수 있는 여러 액세스 토큰을 지원합니다.
Twurl은 RubyGems를 사용하여 설치할 수 있습니다.
gem install twurl
아직 신청하지 않았다면 가장 먼저 해야 할 일은 Twitter API에 액세스하기 위한 개발자 계정을 신청하는 것입니다.
https://developer.twitter.com/en/apply-for-access
해당 액세스 권한을 얻은 후에는 Twitter 앱을 만들고 소비자 키와 비밀번호를 생성할 수 있습니다.
고객 키와 비밀번호가 있으면 Twitter 계정에 해당 고객 키와 비밀번호로 API 요청을 할 수 있는 권한을 부여하는 것입니다.
twurl authorize --consumer-key key
--consumer-secret secret
그러면 브라우저에서 열어야 하는 URL이 반환됩니다. Twitter에 인증한 다음 반환된 PIN을 단말기에 다시 입력하세요. 모든 것이 잘 작동한다고 가정하면 API를 사용하여 요청할 수 있는 권한이 부여됩니다. Twurl이 여러분에게 많은 것을 알려줄 것입니다.
가장 간단한 요청은 요청하려는 경로를 지정하기만 하면 됩니다.
twurl /1.1/statuses/home_timeline.json
컬과 유사하게 GET 요청이 기본적으로 수행됩니다.
POST 매개변수를 지정하는 -d 옵션을 전달하여 암시적으로 POST 요청을 수행할 수 있습니다.
twurl -d ' status=Testing twurl ' /1.1/statuses/update.json
-X(또는 --request-method) 옵션을 사용하여 수행할 요청 방법을 명시적으로 지정할 수 있습니다.
twurl -X POST /1.1/statuses/destroy/1234567890.json
authorize
하위 명령과 함께 --bearer
옵션을 사용하여 전달자 토큰을 생성할 수 있습니다.
twurl authorize --bearer --consumer-key key
--consumer-secret secret
그런 다음 --bearer
요청 옵션을 사용하여 생성된 Bearer 토큰을 사용하여 요청할 수 있습니다.
twurl --bearer ' /1.1/search/tweets.json?q=hello '
생성된 Bearer 토큰을 나열하려면 bearer_tokens
하위 명령을 사용할 수 있습니다.
twurl bearer_tokens
그러면 Consumer_key 쌍과 관련 전달자 토큰이 인쇄됩니다. 이 출력에서는 토큰이 생략되었습니다.
-H 플래그를 사용하여 다른 Twitter API에 대한 다른 호스트에 액세스할 수 있습니다.
twurl -H " ads-api.twitter.com " " /7/accounts "
바이너리 파일을 업로드하려면 호출 형식을 양식 게시물로 지정할 수 있습니다. 아래에서 바이너리는 "/path/to/media.jpg"이고 양식 필드는 "media"입니다.
twurl -H " upload.twitter.com " -X POST " /1.1/media/upload.json " --file " /path/to/media.jpg " --file-field " media "
twurl alias h /1.1/statuses/home_timeline.json
그런 다음 전체 경로 대신 "h"를 사용할 수 있습니다.
twurl h
추가 옵션(예: 요청 매개변수)이 필요한 경로는 예상대로 전체 명시적 경로와 동일한 별칭과 함께 사용할 수 있습니다.
twurl alias tweet /1.1/statuses/update.json
twurl tweet -d " status=Aliases in twurl are convenient "
귀하의 계정을 대신하여 요청을 수행하도록 클라이언트 애플리케이션에 처음 권한을 부여하면 twurl은 ~/.twurlrc
파일에 액세스 토큰 정보를 저장합니다. 후속 요청에서는 이 프로필을 기본 프로필로 사용합니다. accounts
하위 명령을 사용하면 어떤 클라이언트 응용 프로그램이 어떤 사용자 이름에 대해 승인되었는지 확인할 수 있습니다.
twurl accounts
noradio
HQsAGcBm5MQT4n6j7qVJw
hhC7Koy2zRsTZvQh1hVlSA (default)
testiverse
guT9RsJbNQgVe6AwoY9BA
해당 소비자 키 중 하나가 기본값으로 표시되어 있습니다. 기본값을 변경하려면 set
하위 명령을 사용하여 사용자 이름(명확한 경우)만 전달하고, 사용자 이름과 소비자 키 쌍(명확하지 않은 경우)을 전달합니다.
twurl set default testiverse
twurl accounts
noradio
HQsAGcBm5MQT4n6j7qVJw
hhC7Koy2zRsTZvQh1hVlSA
testiverse
guT9RsJbNQgVe6AwoY9BA (default)
twurl set default noradio HQsAGcBm5MQT4n6j7qVJw
twurl accounts
noradio
HQsAGcBm5MQT4n6j7qVJw (default)
hhC7Koy2zRsTZvQh1hVlSA
testiverse
guT9RsJbNQgVe6AwoY9BA
기본 프로필을 변경하면 사용할 액세스 토큰(OAuth1.0a)을 선택할 수 있지만 애플리케이션 전용 인증에는 사용자 컨텍스트가 필요하지 않으므로 전달자 토큰은 사용자 프로필에 연결되지 않습니다. 즉, 이 소비자 키를 사용하여 전달자 토큰을 생성한 후 -c
( --consumer-key
) 옵션을 지정하면 기본 프로필에 관계없이 애플리케이션 전용 요청을 할 수 있습니다. 기본적으로 twurl은 ~/.twurlrc
파일에서 현재 프로필의 소비자 키와 관련 전달자 토큰을 읽습니다.
마르셀 몰리나 / @noradio
에릭 마이클스 오버 / @sferik
그리고 더 많은 것이 있습니다!