이 가이드는 Make에서 29일마다 API 키를 갱신하는 시나리오 글의 실습용입니다. 개념과 배경은 본문 글에서 먼저 확인하세요.
Make에서 API 키의 갱신 기준을 확인하고, 마지막 갱신 성공 시점을 기준으로 다음 갱신일을 관리합니다. 갱신에 성공한 경우에만 새 키와 다음 날짜를 저장해 수동 갱신 누락을 줄일 수 있습니다.
전체 흐름
1
갱신 기준 확인만료일과 갱신 가능 시점을 확인합니다.
2
실행 조건 설정정기 실행 후 저장된 다음 갱신일을 확인합니다.
3
조건에 맞을 때 요청갱신일이 된 경우에만 API에 요청합니다.
4
응답 확인성공 여부와 새 키 값을 확인합니다.
5
키와 다음 날짜 저장갱신에 성공한 경우에만 값을 기록합니다.
사전 준비
- API 키를 발급한 제공처의 문서와 해당 API에 접근할 권한이 필요합니다.
- Make 계정과 시나리오를 만들거나 수정할 권한이 필요합니다.
- 현재 API 키를 저장하고 사용하는 위치와 이를 사용하는 시나리오를 확인합니다.
- 다음 갱신일을 저장할 위치와 날짜 형식을 정합니다.
- 키 만료 기준, 사전 갱신 가능 여부, 기존 키의 유효 기간을 확인합니다.
단계별로 따라 하기
1. 갱신 기준 확인
제공처 문서에서 키가 발급 시점부터 29일 뒤에 만료되는지, 정해진 날짜에 만료되는지 확인합니다. 만료 전 갱신이 가능한지와 새 키 발급 후 기존 키가 언제까지 유효한지도 살펴봅니다.
- 제공처가 정한 갱신 규칙이 있으면 그 규칙을 우선합니다.
- 마지막 갱신 성공 시점을 기준으로 다음 갱신일을 계산할 수 있는지 확인합니다.
갱신 주기와 날짜 계산 방식은 API 제공처마다 다를 수 있습니다. 적용 전에 해당 제공처의 규칙을 확인합니다.
2. 정기 실행과 날짜 조건 설정
Make 시나리오를 정기적으로 실행하고, 저장된 다음 갱신일과 현재 날짜를 비교하도록 구성합니다. 날짜 형식과 시나리오의 시간대가 일치하는지 확인합니다.
- 저장된 다음 갱신일이 되지 않았으면 갱신 요청을 보내지 않습니다.
- 갱신일이 되었으면 다음 단계로 진행하도록 조건을 설정합니다.
3. 갱신 요청 구성
조건을 만족한 경우에만 API 제공처에 갱신 요청을 보냅니다. 요청 방식과 인증 정보, 필요한 입력값은 제공처 문서에 맞춰 구성합니다. Make의 사용 중인 화면에서 요청과 응답을 처리할 단계를 확인합니다.
요청을 너무 자주 보내면 제공처의 제한에 걸릴 수 있습니다. 허용 요청 횟수와 재시도 간격은 제공처 문서에서 확인합니다.
4. 응답 확인 후 키 교체
응답이 성공인지 확인하고, 새 키 값이 비어 있지 않은지도 확인합니다. 검증을 마치기 전에는 기존 키를 덮어쓰지 않습니다. 키가 저장된 위치와 해당 키를 사용하는 시나리오를 확인한 뒤 새 값으로 교체합니다.
- 새 키로 요청을 시험할 수 있다면 정상 동작을 확인한 뒤 사용 경로를 바꿉니다.
- 새 키 발급 시 기존 키가 폐기되는 경우에는 응답과 오류 처리를 특히 주의해서 확인합니다.
5. 성공한 경우에만 다음 날짜 기록
키 갱신이 성공한 경우에만 새 키와 다음 갱신일을 저장합니다. 다음 날짜는 마지막 갱신 성공 시점과 확인한 만료 기준을 바탕으로 계산합니다. 갱신 실패 시에는 다음 날짜를 앞당겨 기록하지 않아 이후 실행에서 다시 확인할 수 있게 합니다.
오류 알림과 로그에는 점검에 필요한 단계나 응답 코드만 기록합니다. API 키와 인증 값은 기록하지 않도록 설정을 확인합니다.
체크리스트
0 / 7
운영 메모
- 갱신 요청이 실패하면 다음 실행에서도 조건을 확인할 수 있는지 점검합니다. 재시도 간격과 허용 횟수는 제공처 기준에 맞춥니다.
- 날짜 비교가 예상과 다르면 시나리오 시간대와 저장된 날짜 형식을 먼저 확인합니다.
- 키 교체 후 API 요청이 실패하면 교체된 값과 사용 시나리오를 확인하고, 제공처에서 허용하는 복구 방법을 따릅니다.
- 로그와 알림에 인증 값이 노출되지 않는지 운영 중에도 확인합니다.