인증과 권한

AiBLE은 요청을 보낸 서비스와 실제 사용자를 함께 확인한 뒤, 그 사용자가 지금 볼 수 있는 범위에서만 결과를 돌려줍니다.

두 가지 신원

설치 인증

어느 파트너 서비스가 호출하는지 증명합니다. 서비스마다 발급하는 시험 키·운영 키입니다.

Authorization: Bearer …

실제 사용자 위임

누구를 대신해 호출하는지 증명합니다. 권한 판단과 사람 확정의 기준이 됩니다.

방식 미결정

설치 키와 이메일 헤더만으로는 실제 사용자 신원과 확정 의사를 증명할 수 없습니다. 사용자 위임 방식은 Backend 계약에서 정합니다.

설치 키로 파트너 서비스를 확인합니다.
위임된 사용자를 확인합니다.
요청이 지정한 공간을 그 사용자가 지금 볼 수 있는지 확인합니다. 하나라도 볼 수 없으면 검색하지 않고 403 FORBIDDEN_SPACE를 돌려줍니다.
허용된 공간 안에서만 조회·검색합니다. 권한은 검색 결과를 거른 뒤가 아니라 검색 전에 적용합니다.

시험 키는 운영과 분리된 시험 환경에서만 동작합니다. 코드에 직접 쓰지 말고 AIBLE_TEST_KEY 같은 환경 변수로 보관하세요. 발급 절차는 시험 API를 열 때 안내합니다.

이 문서의 직접 호출은 ‘권한 있는 사용자 / 권한 없는 사용자 / 키 없음’ 세 합성 사용자를 고를 수 있습니다. 실제 키나 사용자 정보는 쓰지 않습니다.

Backend 계약에서 해소할 항목