제품에 게시 기능 추가.

단계별 안내

1. 01

   API 호출 전에 제품 확인 단계 설계

   SosoAPI에서 이 영역 열기

   • SosoAPI 앱에서 원하는 Workspace를 선택하고 연결된 계정을 검토하세요. 제품 목업에도 같은 사용자 선택 Workspace와 계정을 표시하고 조용히 대신 선택하지 마세요.

   • 확인 단계에서 정확한 캡션, 계정, 현지 시간, 시간대를 보여주세요. 당사자가 Schedule을 선택해야 하며 양식 열기만으로 제출되어서는 안 됩니다.

   예상 결과

   쓰기 전에 사람이 대상과 시간을 확인할 수 있습니다. 가상 제품 목업은 설계 연습이며 설치된 고객 통합이 아닙니다.

2. 02

   서버에서 현재 Scheduled Posts 읽기

   • <workspace-uuid>를 선택한 Workspace ID로 교체하고 서버에서 이 읽기 전용 요청을 실행하세요:

   • const apiKey = process.env.SOSOAPI_API_KEY;
     if (!apiKey) throw new Error("Configure a SosoAPI API key on your server");
     const response = await fetch(
       "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/list",
       {
         method: "POST",
         headers: {
           "Authorization": "Bearer " + apiKey,
           "Content-Type": "application/json"
         },
         body: JSON.stringify({"workspace_id":"<workspace-uuid>"})
       }
     );
     const result = await response.json();
     if (!response.ok) throw new Error("SosoAPI request failed: " + response.status);
     // Use result in your server response; never return or log the API key.

   • 반환 데이터로 제품 목록을 갱신하세요. 사용자 확인은 이 읽기와 별도로 유지하세요.

   예상 결과

   Workspace의 현재 게시물 또는 인증/검증 오류를 받습니다. 이 읽기 전용 요청은 게시물을 생성하지 않습니다.

3. 03

   사용자의 명시적 확인 후에만 제출

   • Calendar를 열고 New Post를 선택하여 같은 앱 작업의 검토 단계를 비교하세요.

   • 모든 자리표시자를 승인된 ID, 오프셋이 있는 미래 ISO 시각, 고유 멱등성 키로 교체하세요. 서버 측 요청 실행 전에 계정, 문구, 시간을 검토하세요.

   • const apiKey = process.env.SOSOAPI_API_KEY;
     if (!apiKey) throw new Error("Configure a SosoAPI API key on your server");
     const response = await fetch(
       "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/create",
       {
         method: "POST",
         headers: {
           "Authorization": "Bearer " + apiKey,
           "Content-Type": "application/json"
         },
         body: JSON.stringify({
       "workspace_id": "<workspace-uuid>",
       "social_account_id": "<threads-social-account-uuid>",
       "caption": "A small note for later: Harborlight Journal is making room for shorter daily reflections. Keep one thought; leave the rest for tomorrow.",
       "hashtags": [],
       "media": [],
       "provider_payload": {"platform": "threads", "publish_options": {"post_type": "TEXT"}},
       "scheduled_at": "<future ISO-8601 instant with offset>",
       "display_timezone": "Asia/Hong_Kong",
       "idempotency_key": "<unique-stable-key-for-this-intent>"
     })
       }
     );
     const result = await response.json();
     if (!response.ok) throw new Error("SosoAPI request failed: " + response.status);
     // Use result in your server response; never return or log the API key.

   • 이 요청을 실행하면 실제 예약이 생성됩니다. 사용자 확인 후에만 제출하고 API 키를 브라우저에 노출하지 마세요.

   예상 결과

   유효한 접수 응답은 생성된 Scheduled Post를 식별하며 제공업체 게시를 증명하지 않습니다. 기능 거부, 잘못된 범위/계정, 미지원 페이로드, 예약 거부는 성공이 아닌 오류로 표시해야 합니다.

4. 04

   반환된 상태를 표시하고 사용자에게 안전한 후속 조치 제공

   SosoAPI에서 이 영역 열기

   • 반환된 Scheduled Post ID를 저장하고 제품에 현재 상태, 대상, 예약을 표시하세요.

   • 해당 Scheduled Post 상세로 사용자를 연결하세요. 전송에 사람의 조치가 필요하면 조용히 재제출하는 대신 Needs Attention 항목을 연결하세요.

   • 제공업체가 확인한 최종 상태가 기록될 때까지 요청을 게시 완료로 표시하지 마세요.

   예상 결과

   제품은 요청 영수증과 예약, 게시 중, 게시 완료, 실패, 알 수 없음 관찰을 구별합니다. 알 수 없는 결과는 새 쓰기 전에 기존 게시물과 대조합니다.