텍스트 / URL 포스팅
외부 앱, 모바일웹에서 텍스트 혹은 url 포함 텍스트를 카카오스토리로 포스팅할 수 있습니다. 본문에 url이 포함되어 있을 경우 해당 페이지의 썸네일 이미지, 제목, 설명이 자동으로 스크랩되어 포스팅 됩니다.
원하는 정보를 전달하려면 파라미터 중 urlinfo를 활용할 수 있습니다.
지원 OS : iOS, Android, 모바일웹
이미지 포스팅
외부 앱에서 카카오스토리에 이미지를 포스팅할 수 있습니다. Custom URL Scheme 형태가 아닌 OS Content Type 공유를 통해 포스팅 됩니다.
지원 OS : iOS, Android
아이폰
iPhone에서는 iOS의 Custom URL Scheme을 사용하여 스토리링크를 호출합니다.
텍스트 / URL 포스팅
Custom URL Scheme
파라미터 설명
파라미터 이름 | Type | 필수여부 | 설명 | 비고 |
---|---|---|---|---|
post | String | O |
Article 사용자 메시지 내용(UTF-8) 또는 URL * 본문에 url이 포함되어 있을 경우 해당 페이지의 썸네일 이미지, 제목, 설명이 자동으로 스크랩되어 포스팅 됩니다. 원하는 정보를 전달하려면 파라미터 중 urlinfo를 활용할 수 있습니다. * 본문에 url이 없는 경우 urlinfo를 보내도 동작하지 않습니다. |
* 스토리 앱 버전 2.2.0
이후부터는 이미지가 없는경우 및 해상도에 따라서 최적화된 UI 제공 (예시 참고) |
appid | String | O | App일 경우 bundle id, 모바일 사이트일 경우 domain | |
appver | String | O | app 또는 모바일 사이트의 버전 | |
apiver | String | O | 스토리링크 API 버전 | 1.0(고정값) |
appname | String | O | app또는 모바일 사이트의 정확한 이름 |
host(출저)로 이용하니 정확히 기재 |
urlinfo | String | X |
스크랩 기능을 동작할 경우 원하는 정보를 전달하기 위한 url 정보. |
urlinfo 설명
파라미터 이름 | 필수여부 | 설명 | 종류 |
---|---|---|---|
title | O | 스크랩 형태에 표시되는 제목 | |
desc | X | 스크랩 형태에 표시되는 설명 |
* 스토리 앱 버전 2.2.0
이후부터는 이미지가 없는 경우에만 노출(예시 참고) |
imageurl | X |
스크랩 형태에 표시되는 대표이미지 url (JSON Object의 String Array 형식으로 지원) |
|
type | X | 스크랩 형태에 사용되는 type |
video, music, book, article, profile, website 기본값은 website |
스크랩이란?
본문에 url이 포함되어 있을 경우 해당 페이지의 썸네일 이미지, 제목, 설명 정보를 서버에서 자동으로 parsing 후 포스트의 정보에 삽입하는 것을 말합니다. 자동으로 스크랩하지 않고 원하는 정보를 지정하여 전달하려면, 파라미터 중 urlinfo를 활용할 수 있습니다. urlinfo의 'imageurl', 'title', 'desc'을 설정하면 아래 예시의 각 영역에 원하는 결과를 노출시킬 수 있습니다.
예시
아이폰 OS 공유기능 활용
위 방법 외에도 iOS에서 제공하는 공유 기능을 활용하여 텍스트/url, 이미지를 포스팅할 수 있습니다.
구체적인 정의는
http://developer.apple.com/library/ios/#documentation/UIKit/Reference/
UIDocumentInteractionController_class/Reference/Reference.html
를
참조하세요.
사용예
다운로드
개발자용 카카오스토리 B.I 다운로드: kakaostory_icon_guide.zip
*B.I는 스토리링크를 이용하여 카카오스토리로 포스팅하는 기능을 안내하는 버튼/페이지에 한하여 사용하셔야 하며,
다른 페이지나 메뉴 등에서 위 이미지를 그대로 또는 일부 변형하여 사용자가 카카오 제작 앱으로 혼동하게 하시면 안됩니다.