# 인증

PINK API에 연결하려면 PINK API 키를 생성해야 합니다. 새 키를 생성하려면 PINK API 키 페이지를 방문하세요.

"새 API 키"를 클릭하면 생성된 키에 대한 권한과 사용 제한을 선택하라는 메시지가 표시됩니다. 관리자 권한은 모든 API 엔드포인트에 대한 액세스 권한을 제공합니다. 특정 엔드포인트를 지정하려면 엔드포인트의 상위 경로를 확장하고 필요한 권한을 토글하면 됩니다.

기본적으로 모든 키는 무제한으로 사용할 수 있습니다. 그러나 키를 사용할 수 있는 횟수를 제한하려면 "최대 사용 횟수" 필드를 적절히 설정하면 됩니다.

의미 있는 '키 이름'을 설정하면 키와 그 용도를 쉽게 식별하는 데 도움이 됩니다.

필요한 경우 "해지" 버튼을 클릭하여 모든 키에 대한 액세스 권한을 해지할 수 있습니다. 키가 해지되면 어떤 용도로도 사용할 수 없습니다.

**중요:**

키를 생성하면 모달에 PINK API 키, PINK API 비밀 및 JWT(JSON Web Token)가 표시됩니다. "PINK API 키"는 트위터 REST API의 공개 키 역할을 하며, "PINK 시크릿 API 키"는 공개 키의 비밀번호 역할을 합니다. JWT는 이 두 가지를 인코딩한 조합입니다. 비밀 키를 비공개로 유지하시기 바랍니다.

보안 강화를 위해 이 키는 PINK 측에서 암호화되며 한 번만 표시됩니다. 백업용으로 적어두는 것이 중요합니다. 이 값을 분실하면 키를 해지하고 새 키를 생성해야 합니다.

**PINK API에 연결합니다:**

PINK API 요청의 기본 URL은 <https://api.mypink.cloud> 입니다.

PINK API에 연결하는 방법은 두 가지가 있습니다:

1. 무기명 인증: 베어러 체계를 사용하여 인증 헤더에 API 키를 포함할 수 있습니다.
2. 사용자 지정 헤더: API 키 및 기타 필수 헤더를 요청에 직접 전달할 수 있습니다.

API 연결 및 사용 가능한 엔드포인트 활용에 대한 자세한 지침은 PINK API 설명서를 참조하세요.
