근거 검색

제안
POSThttps://sandbox.api.aible.example/v1/searchsearch

지정한 공간에서 현재 사용자가 볼 수 있는 기억을 찾고 원문 인용과 위치를 함께 반환합니다. 권한은 검색 전에 적용되며, 볼 수 없는 공간을 지정하면 검색하지 않고 403 FORBIDDEN_SPACE를 반환합니다.

헤더

  • Authorizationstring헤더필수

    Bearer <시험 키>. 실제 사용자 위임 방식은 미결정입니다.

요청 본문

  • querystring필수

    자연어 질문

  • space_idsstring[]필수

    검색할 공간 ID. 볼 권한이 없는 공간이 하나라도 있으면 403

반환값

  • hitsobject[]

    관련 기억

    • typestring

      결과 종류

      허용 값 item

    • idstring

      기억 ID

    • space_idstring

      공간 ID

    • titlestring

      기억 제목

    • statusstring

      후보 또는 확정

      허용 값 candidateconfirmed

    • evidenceobject[]

      원문 인용과 위치

      • source_idstring

        원문 자료 ID

      • source_typestring

        원문 종류

        허용 값 recordingdocument

      • source_titlestring

        원문 제목

      • locatorobject

        원문 위치. 녹음은 초 단위 t0–t1

      • quotestring

        원문 인용

오류

  • 400INVALID_REQUEST

    입력 오류

  • 401UNAUTHENTICATED

    인증 실패

  • 403FORBIDDEN_SPACE

    볼 권한이 없는 공간