한 번 업로드하고, 어디에나 게시
미디어 라이브러리에 파일을 보내면 id를 돌려받아요. 그 id를 여러 게시물에 첨부하면 FoPost가 각 네트워크가 원하는 형태로 변환해 전송해요. 저장소는 비공개이고 워크스페이스 범위로 제한돼요.
curl -X POST "https://api.fopost.com/v1/media/upload?workspace_id=9b2f6c1e-..." \
-H "X-API-Key: $API_KEY" \
-F "[email protected]"
{
"data": [
{
"id": "e5a1c9d4-...",
"type": "image",
"name": "launch.png",
"url": "https://.../launch.png",
"preview_url": "https://api.fopost.com/v1/media/e5a1c9d4-.../file",
"size": 412883
}
]
}멀티파트 업로드
최대 50 MB의 이미지와 동영상을 확장자만이 아니라 실제 내용으로 검증해요.
id로 재사용
한 번 업로드로 여러 게시물에. 파일을 두 번 보낼 일이 없어요.
기본적으로 비공개
파일은 비공개 저장소에 보관되며 워크스페이스 멤버에게만 제공돼요.
하나의 입구, 도착 즉시 검사
모든 파일은 같은 경로를 거쳐요. MIME 허용 목록, 실제 바이트 검사, 크기 상한, 계정의 무료 저장 용량을 확인해요. 결과로 유형과 크기가 담긴 라이브러리 항목이 반환되어 바로 첨부할 수 있어요.
미디어 레퍼런스 읽기curl -X POST https://api.fopost.com/v1/posts \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspace_id": "9b2f6c1e-...",
"content": [{ "text": "Launch day.", "media": [{ "type": "image", "name": "launch.png", "url": "https://.../launch.png" }] }],
"accounts": ["4a71d80b-..."]
}'이미지
PNG, JPEG, GIF, WebP를 지원하며, 업로드할 때 유형과 크기를 읽어요.
동영상
MP4와 MOV를 지원하며, 게시할 때 길이와 크기를 네트워크별로 확인해요.
검증 완료
파일의 실제 내용이 유형과 일치해야 하며, 그렇지 않으면 업로드가 거부돼요.
네트워크마다 알맞은 형식으로 알아서
네트워크마다 화면 비율, 크기, 코덱 기준이 달라요. 게시할 때 각 어댑터가 저장된 원본을 가져와 해당 플랫폼이 허용하는 형태로 업로드하므로, 라이브러리 에셋 하나를 캐러셀, 스레드, 숏폼 동영상 피드에 똑같이 쓸 수 있어요.
전송 방식 보기
네트워크별 규칙
크기와 형식 제한은 직접 맞출 필요 없이 어댑터가 적용해요.
미디어 순서
콘텐츠 블록의 순서가 곧 캐러셀의 순서예요.
명확한 실패 처리
네트워크가 받을 수 없는 파일은 게시물 전체가 아니라 해당 전송만 이유와 함께 실패해요.
라이브러리를 탐색하고, 가져오고, 재사용
필터로 라이브러리를 조회하고, 요청마다 워크스페이스 멤버십을 확인하며 만료되지 않는 파일 엔드포인트로 에셋을 가져오고, 같은 id를 원하는 만큼 많은 게시물에서 참조하세요. 브랜드 에셋, 가져온 파일, 생성된 이미지가 모두 같은 라이브러리에 모여요.
개발 시작하기curl "https://api.fopost.com/v1/media?workspace_id=9b2f6c1e-...&type=image" \
-H "X-API-Key: $API_KEY"
# Fetch the file itself
curl -L "https://api.fopost.com/v1/media/e5a1c9d4-.../file" \
-H "X-API-Key: $API_KEY" -o launch.png조회 및 필터
유형, 출처, 브랜드 역할별로, 페이지네이션과 함께.
변하지 않는 파일 URL
/v1/media/:id/file always works for members; no signed links to refresh.
워크스페이스 범위
키는 하나의 워크스페이스 라이브러리만 볼 수 있어요.