Renamed.to REST API v1
단일 API 호출로 어지러운 업로드 파일을 일관되고 읽기 쉬운 파일 이름으로 변환하십시오. Renamed.to는 파일 자체를 읽어(스캔본은 OCR, 텍스트는 NLP) 올바른 필드를 추출한 다음 귀하의 이름 지정 템플릿을 적용하여 매번 정확히 예상되는 파일 이름을 반환합니다. Bearer 토큰 인증을 사용한 깨끗한 JSON 입출력으로 몇 분 만에 통합할 수 있습니다.
기존 이름이 아닌 콘텐츠를 기반으로 파일 이름을 변경하십시오.
- 파일을 읽어(스캔본은 OCR) 실제 메타데이터를 추출합니다
- 귀하가 제어하는 템플릿: 자동, 기성, 또는 자연어 맞춤 템플릿
- 어디서나 작동하는 문자를 사용한 일관되고 안전한 출력
- Bearer 토큰 인증을 사용한 JSON 우선 REST API
- 스마트 라우팅 및 구성을 위한 선택적 폴더 경로
- 장기 콘텐츠 저장을 피하는 개인정보 보호 우선 기본값
시작하기: 무료 크레딧 50개 for new accounts.
기본 URL
빠른 시작: 에서 API 토큰을 생성하십시오 설정 → API 토큰, 그런 다음 아래 예제를 사용하여 첫 번째 요청을 수행하십시오.
시작하기
몇 분 만에 Renamed.to REST API를 시작하고 실행하십시오. 다음 단계를 따라 첫 번째 API 호출을 수행하고 프로그래밍 방식으로 PDF 파일 이름 변경을 시작하십시오.
계정 생성
에서 무료 계정에 가입하십시오 renamed.to/sign-up. 새 계정은 시작을 위해 50개의 무료 크레딧을 받습니다.
API 토큰 생성
로 이동하십시오 설정 → API 토큰그리고 새 API 토큰을 생성하십시오. 토큰은 생성 시 한 번만 표시되므로 안전하게 저장해야 합니다.
팁: 여러 토큰을 관리하는 데 도움이 되도록 토큰에 설명적인 이름을 사용하십시오(예: "프로덕션 서버", "개발").
첫 번째 요청 수행
API 토큰을 사용하여 요청을 인증하십시오. 서비스는 PDF 파일에서 자동으로 메타데이터를 추출합니다. 다음은 최소한의 예입니다:
참고: 이것은 시작을 위한 단순화된 예제입니다. 포괄적인 오류 처리, 재시도 논리 및 검증을 포함한 프로덕션 코드는 오류 처리
curl -X POST https://www.renamed.to/api/v1/rename \
-H "Authorization: Bearer rt_your_token_here" \
-F file=@invoice.pdf응답 처리
성공적인 응답에는 추출된 메타데이터와 함께 생성된 파일 이름 및 폴더 경로가 포함됩니다:
일반적인 문제
- Python 415 오류: Python을 사용하는 경우 파일 업로드에 파일 이름 및 content-type이 포함되어 있는지 확인하십시오(참조: Python 파일 업로드 요구 사항)
- 401 오류: API 토큰이 올바르고 필요한 권한이 있는지 확인하십시오
- 파일 크기: PDF 파일 및 스캔 이미지(JPG, PNG, TIFF)의 최대 파일 크기는 25MB입니다
다음 단계
- 읽기 인증
- 탐색 Rename 엔드포인트
- 검토 오류 처리
- 확인 사용 사례 예제
- 참조 문제 해결
도움이 필요하십니까? 다음을 확인하십시오 문서 or contact support if you run into any issues.
API 버전 관리
Renamed.to API는 플랫폼이 발전함에 따라 안정성과 하위 호환성을 보장하기 위해 URL 기반 버전 관리를 사용합니다.
현재 버전
현재 API 버전은 v1이며 다음에서 액세스할 수 있습니다:
https://www.renamed.to/api/v1버전 관리 정책
하위 호환성
각 주요 버전 내에서 하위 호환성을 유지합니다. 새로운 기능 및 중단되지 않는 변경 사항은 통합에서 코드 변경을 요구하지 않고 현재 버전에 추가됩니다.
중단 변경
중단 변경(제거된 엔드포인트, 변경된 응답 형식, 제거된 필드)은 새로운 주요 버전(예: v2)이 됩니다. 새로운 주요 버전이 릴리스되면:
- 이전 버전은 최소 12개월 동안 사용 가능합니다
- 마이그레이션 가이드 및 사용 중단 공지를 제공합니다
- 중단 변경은 최소 90일 전에 공지됩니다
사용 중단 일정
버전이 사용 중단되면 다음 일정을 따릅니다:
- 90일 공지: 마이그레이션 가이드와 함께 사용 중단 공지
- 12개월 지원: 사용 중단된 버전은 계속 작동합니다
- 종료: 지원 기간 후 사용 중단된 버전이 폐기됩니다
특정 버전 요청
API 버전은 URL 경로에 지정됩니다. 요청에 항상 버전 번호를 포함하십시오:
https://www.renamed.to/api/v1/rename✓ 현재 버전https://www.renamed.to/api/v2/rename향후 버전(아직 사용할 수 없음)버전 헤더
버전 관리는 URL 경로를 통해 처리되지만 API 응답에는 헤더에 버전 정보가 포함됩니다:
| 헤더 | 설명 | 예제 |
|---|---|---|
API-Version | 요청에 사용된 API 버전 | v1 |
최신 상태 유지
API 변경 사항 및 버전 업데이트에 대한 정보를 얻으려면:
- 확인 변경 로그
- API 변경 로그 RSS 피드 구독(곧 제공)
- 응답에서 API-Version 헤더 모니터링
- API 가용성 및 인시던트에 대한 상태 페이지 팔로우
Note: 참고: API v1은 안정적이며 적극적으로 유지 관리됩니다. 가까운 미래에 v1을 사용 중단할 계획이 없습니다. v2가 릴리스되면 두 버전이 동시에 지원됩니다.
인증
모든 요청은 Bearer 토큰을 사용하여 인증되어야 합니다. API 토큰은 귀하의 계정에 대한 전체 액세스를 제공하는 장기 API 키입니다.
토큰 형식
API 토큰은 rt_ 접두사 다음에 64개의 16진수 문자가 옵니다. 예: rt_abc123def456...
토큰 받기
설정의 API 토큰 섹션에서 API 토큰을 생성하십시오. 토큰은 생성 시 한 번만 표시되므로 안전하게 저장해야 합니다.
토큰 사용
Bearer 접두사와 함께 Authorization 헤더에 토큰을 포함하십시오:
curl -X GET https://www.renamed.to/api/v1/user \
-H "Authorization: Bearer rt_your_token_here"토큰 권한
API 토큰은 파일 이름 변경, 사용자 프로필 정보, 크레딧 잔액 및 팀 정보를 포함한 모든 API 엔드포인트에 대한 액세스를 제공합니다.
오류 응답
인증에 실패하면 401 Unauthorized 응답을 받게 됩니다:
토큰 보안
- 토큰을 안전하게 저장하십시오. 버전 관리에 커밋하거나 클라이언트 측 코드에 노출하지 마십시오
- 환경 변수 또는 안전한 비밀 관리 시스템 사용
- 설정 → API 토큰에서 새 토큰을 생성하고 이전 토큰을 삭제하여 정기적으로 토큰을 교체하십시오
- 토큰이 손상된 경우 설정에서 즉시 삭제하십시오