API 및 위젯

LiKE AI 검색을 귀하의 애플리케이션, 웹사이트 또는 내부 시스템에 임베드하십시오. 세 가지 통합 방법: REST API, JS 위젯, iframe.

#REST API

#1단계 — API 키 생성

1. 통합 → Public API → "키 생성"
2. 이름 입력(예: "Mobile app")
3. 키 복사 — 한 번만 표시됩니다

#2단계 — API 사용

모든 요청은 헤더를 통해 인증됩니다:

X-API-Key: your-key

#핵심 엔드포인트

#예시: AI 검색

curl -X POST https://amedia.lynkora.pro/api/public/search \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Как оформить отпуск?"}'

응답:

{
  "answer": "Для оформления отпуска...",
  "sources": [
    {"title": "Политика отпусков", "url": "..."}
  ]
}

#속도 제한

API 요청은 키별로 제한됩니다. 구체적인 제한은 요금제에 따라 다릅니다; 초과되면 Retry-After 헤더와 함께 HTTP 429가 반환됩니다. 귀하 요금제의 정확한 값은 요금제 섹션에 있습니다.

#보안

1. 키를 코드가 아닌 환경 변수에 저장하십시오
2. 각 애플리케이션마다 별도의 키를 생성하십시오
3. 사용하지 않는 키는 삭제하십시오
4. 키 설정에서 도메인을 제한하십시오

#JS 위젯

모든 웹사이트에 임베드할 수 있는 플로팅 AI 검색 버튼입니다.

#1단계 — 코드 받기

1. 통합 → JS Widget
2. 매개변수 구성(아래 표 참조)
3. 코드 복사

#2단계 — 사이트에 추가

복사한 <script>를 닫는 </body> 태그 앞에 삽입하십시오:

#위젯 매개변수

#결과

사이트 모서리에 보라색 버튼이 나타납니다. 클릭하면 → 검색창이 있는 모달 창 → 귀하의 지식 베이스에서 나온 AI 답변.

#iframe

페이지에 임베드되는 완전한 기능의 검색 인터페이스입니다:

#임베드 코드

#직접 링크

iframe이 맞지 않는 경우, 사용자에게 직접 링크를 제공하십시오: https://amedia.lynkora.pro

#데모 모드

API 키 없이 테스트할 수 있도록 제한이 있는 데모 엔드포인트를 사용할 수 있습니다:

엔드포인트: POST /api/public/demo/search

#인증 모드 비교

위젯은 두 가지 인증 모드를 지원합니다.

#모드 A — URL 영역 신뢰

클라이언트 측 인증: 위젯이 있는 페이지에 누가 도달하는지(VPN, SSO, 보호된 경로)는 귀하의 책임입니다. Lynkora는 사용자의 신원을 알지 못하며 — 요청의 Origin/IP만 압니다. 위젯은 임베드 코드가 있는 페이지를 여는 모든 사람에게 표시됩니다.

• 백엔드 코드: 0줄
• 온보딩 시간: 약 2분
• 적합한 대상: 인트라넷, 내부 포털

#모드 B — 세션 토큰(사용자별 JWT)

귀하의 백엔드가 각 사용자에게 수명이 짧은 세션 토큰을 발급합니다. Lynkora는 신원을 알고, 사용자별 감사를 유지하며, 취소 및 GDPR DSAR을 지원합니다.

• 백엔드 코드: 약 10줄(SDK를 통해)
• 온보딩 시간: 1~2시간
• 적합한 대상: 멀티테넌트 SaaS, 규제 산업