런치 URL

런치 URL API는 세션에 안전하게 진입할 수 있는 URL을 발급해요.

엔드포인트

POST /api/b2b/sessions/:id/launch-url

동작 개요

1. 파트너 인증(API 키) 확인
2. 세션 소유/상태 검증
3. 서버에서 서명된 URL 생성
4. URL/만료 정보를 JSON으로 반환

curl 예시

curl -X POST "https://slash.ai.kr/api/b2b/sessions/42/launch-url" \
  -H "X-API-Key: YOUR_PARTNER_API_KEY"

JavaScript 예시

const res = await fetch('https://slash.ai.kr/api/b2b/sessions/42/launch-url', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.SLASH_B2B_API_KEY,
  },
});
 
if (!res.ok) throw new Error(`launch-url failed: ${res.status}`);
const launch = await res.json();
console.log(launch);

응답

구체 필드는 서버 버전에 따라 확장될 수 있지만, 일반적으로 접속 URL과 관련 메타정보를 반환해요.

사용 패턴

1) 서버 리다이렉트

• 백엔드에서 URL을 발급받고 즉시 302 리다이렉트

2) 프론트 임베드(iframe)

• 백엔드가 발급받은 URL을 프론트에 전달
• 만료 정책을 고려해 재발급 로직 포함

3) 딥링크 전달

• 운영 도구에서 "워크스페이스 열기" 버튼 클릭 시 즉시 발급/이동

오류 케이스

• 404 Session not found: 세션 ID 오입력 또는 이미 파기
• 500 B2B_LAUNCH_SECRET is not configured: 서버 설정 누락
• 인증 실패(401/403 계열): API 키 문제

운영 권장사항

• URL 만료 시간을 짧게 운용
• 사용자 액션 직전에 발급
• 재시도 시 새 URL 재발급
• 발급/사용 로그 분리 저장

관련 가이드

• 세션 API
• 인증
• OpenAPI 명세 엔드포인트