단축어에서 첫 번째 API 요청하기
첫 번째 API를 신청하려면 통신하려는 API ‘엔드포인트’를 가리키는 URL을 생성한 다음, ‘URL 콘텐츠 가져오기’ 동작에 URL을 전달하십시오. 단축어가 실행되면 이 동작은 API 요청을 생성합니다.
API 요청 빌드하기
Dark Sky의 Forecast 엔드포인트는 다음과 같은 포맷의 URL 요청을 요구합니다.
https://api.darksky.net/forecast/[사용자의_시크릿_키]/[위도],[경도]
괄호 안의 텍스트는 API 키 및 사용자가 일기 예보 데이터를 받으려는 위치로 대치됩니다.
단축어 앱에서 URL 동작에 변수로 전달된 첫 번째 텍스트 동작에 Dark Sky에서의 API 키를 배치합니다.
위도
와경도
값은 이미 샌프란시스코의 알카트라즈 섬의 좌표인37.8267
과-122.4233
으로 설정되어 있지만, 사용자가 원하는 대로 변경할 수 있습니다. (이 값들을 다른 위치로 변경할 수 있습니다.)‘현재 위치 가져오기’ 동작을 사용하고 URL 동작의 위도와 경도로 설정된 매직 변수로 배치하여 단축어를 실행할 때마다 지역 날씨 데이터를 가져올 수 있습니다.
URL 콘텐츠 가져오기 동작으로 API 요청 수행하기
단축어 앱의 단축어 편집기에서 ‘URL 콘텐츠 가져오기’를 ‘고급’으로 설정하십시오.
사용자가 생성할 수 있는 다음 API 요청 유형 옵션이 활성화됩니다.
GET
은 데이터 검색을 허용합니다.POST
는 새로운 데이터를 생성하는 것을 허용합니다.PUT
은 데이터를 대치하여 업데이트하는 것을 허용합니다.PATCH
는 데이터를 수정하여 업데이트하는 것을 허용합니다.DELETE
는 URL 요청에서 지정한 객체를 삭제하는 것을 허용합니다.
이 예제에서는
GET
을 사용하여 Dark Sky API에서 데이터를 요청하고 가져옵니다.이제 URL 동작은 사용자의 요청을 받았고 ‘URL 콘텐츠 가져오기’ 동작은 데이터를 가져오도록(
GET
) 설정되어서, 사용자는 API 요청을 생성할 수 있습니다.참고: ‘URL 콘텐츠 가져오기’가
POST
,PUT
또는PATCH
로 전환되면 ‘본문 요청’이라는 새로운 매개변수가 추가됩니다. ‘본문 요청’은 JSON, 양식 또는 파일을 요청의 일부로서 API에 전송하도록 허용합니다. 이로 인해 사용자는 수동으로 또는 변수를 사용하여 새로운 데이터를 입력할 수 있어서 API에 엔트리 생성, 대치 또는 수정을 위한 데이터를 전송할 수 있습니다.을 탭하여 단축어를 테스트하십시오(단축어에서 훑어보기 동작으로 API가 반환하는 데이터를 미리 볼 수 있습니다).
처음에는 API가 많은 텍스트를 반환하는 것으로 보입니다. 이 날씨 데이터는 JSON(JavaScript Object Notation)으로 인코딩되었습니다.
JSON으로 작업하기에 관해 더 알아보고 Dark Sky API 예제를 계속하려면 단축어에서 JSON 사용 개요를 참조하십시오.