간단하게 FL Bricks라는 전자책을 배달할 수 있는 서비스를 사용해 보세요!

기술 서적이 가깝구나!
FL Bricks 서비스의 사용 방법을 총괄하여 기술 서전으로 제작된 종이책을 전자책으로 발송할 수 있다.

FL Bricks


FL Bricks는 자신의 출판 서비스를 전개하고 싶은 출판자를 위한 마이크로서비스 시리즈입니다.
기능 단위로 사용할 수 있기 때문에 자신의 출판 서비스를 유연하게 구축할 수 있다.
FL Bricks는 폐쇄형 베타를 제공하고 있으며 현재 문의를 통해서만 사용자 등록을 할 수 있습니다.
FLB ROOT
FLB ROOT는 출판 컨텐츠를 관리하고 제어하는 서비스입니다.
누가 출판 내용을 등록한 서적 문서와 간행물 정보를 어떻게 사용하는지 관리하고 통제한다.
이 서비스로 전자책을 관리하고 자신의 응용 프로그램을 등록합니다.
FLB BinB
FLB BinB는 웹 브라우저에서 출판 내용을 열람할 수 있는 서비스입니다.
BinB 뷰어에서 열람할 수 있도록 FLB ROOT에서 사용할 수 있는 PDF/ePub 형식의 출판 내용을 변환합니다.
FLB BinB를 사용하면 FLB ROOT에 등록된 전자책을 보낼 수 있습니다.
BinB는 각종 사이트에서 실적이 있는 전자책 리더다.

FLB ROOT 로그인 시도



로그인했습니다.
콘솔은 주로 콘텐츠 소유자와 Brick을 관리하는 데 사용됩니다.
컨텐츠 소유자
컨텐츠 소유자는 컨텐츠를 소유하고 관리하는 조직 또는 개인입니다.예를 들어, 출판, 출판××편집부 등
Brick
Brick은 FL Bricks를 사용하여 구축된 서비스 및 응용 프로그램입니다.
등록하면 API 키 등 개발에 필요한 정보를 얻을 수 있습니다.

샘플 어플을 만들어 보도록 하겠습니다.


트위터나 다른 SNS에서 기술 서적을 위한 책을 읽을 수 있는 사이트를 가정해 샘플을 만들어 보자.

작업 흐름


샘플 프로그램을 만들 때 전체적인 절차를 확인해 보세요.
  • Brick 등록
  • 컨텐츠 등록
  • 등록 컨텐츠 소유자
  • 컨텐츠 사용 권한 설정
  • API 등록 컨텐츠 사용
  • API를 사용하여 파일 업로드
  • API를 사용하여 이미지 업로드
  • 컨텐츠 찾아보기
  • FLB BinB 로그인
  • Brick 정보 등록
  • API를 사용하여 읽기 전용 링크 생성
  • 읽었습니다
  • 1. Brick 등록



    먼저 Redirect URIhttp://localhost를 지정합니다.

    API 키 등의 정보를 얻었습니다.

    2. 콘텐츠 등록


    등록 컨텐츠 소유자

    컨텐츠 사용 권한 설정

    방금 만든 Brick 및 FLB BinB에서 해당 컨텐츠 소유자가 소유한 컨텐츠를 사용할 수 있습니다.
    API를 사용하여 컨텐츠 등록
    다음 등록 API를 사용하여 등록합니다.
    https://console.root.bricks.pub/docs/api/v1#owners-contents-create
    curl --location --request POST "https://api.root.bricks.pub/v1/owners/{あなたのコンテンツオーナーのID}/contents" \
      --header "Content-Type: application/json" \
      --header "X-API-KEY: {BrickのAPIキー}" \
      --header "Authorization: Bearer {Access token}" \
      --data "{
        \"title\": \"FL Bricksという電子書籍を簡単に配信できるサービスを使ってみよう!\",
        \"description\": \"FL Bricksという電子書籍を簡単に配信できるサービスを使ってみよう!\",
        \"authors\": [
            {
                \"name\": \"@shwld\",
                \"role\": \"著\"
            }
        ],
        \"image\": {
            \"filename\": \"cover.jpg\"
        },
        \"file\": {
            \"filename\": \"flb.pdf\",
            \"layout_type\": \"pre_paginated\",
            \"trial_range\": \"-5\"
        }
    }"
    
    이미지 이미지와 PDF 파일을 미리 준비하는 것이 좋습니다.
    응답:
    {
        "data": {
            "id": "xxxxxxxxxxxxxxxx",
            "title": "FL Bricksという電子書籍を簡単に配信できるサービスを使ってみよう!",
            "description": "FL Bricksという電子書籍を簡単に配信できるサービスを使ってみよう!",
            "owner_id": "{あなたのコンテンツオーナーのID}",
            "authors": [
                {
                    "name": "@shwld",
                    "role": "著"
                }
            ],
            "file": {
                "upload_url": "https://s3.ap-northeast-1.amazonaws.com/root.bricks.pub/content_files/eafd96f6-0c97-432a-a677-16dc306004ed/1d9338b0-dbd6-4944-8791-c8cfb5a8fda6.pdf?x-amz-acl=private&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJLLXFHCUMKSFOTJA%2F20190327%2Fap-northeast-1%2Fs3%2Faws4_request&X-Amz-Date=20190327T005943Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=22214dd5895bd06cb70df338c1fcbcd63c954643a7c99c4fb9550964b69d6ff6",
                "layout_type": "pre_paginated",
                "trial_range": "-5",
                "size": null,
                "uploaded_stamp": null
            },
            "image": {
                "upload_url": "https://s3.ap-northeast-1.amazonaws.com/root.bricks.pub/content_images/eafd96f6-0c97-432a-a677-16dc306004ed/7a0c6027-50d5-49fe-8133-3d1dbf2f92cf/default.jpeg?x-amz-acl=public-read&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJLLXFHCUMKSFOTJA%2F20190327%2Fap-northeast-1%2Fs3%2Faws4_request&X-Amz-Date=20190327T005943Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=dfe2e8de69df68d1049e578ebb43b0072bfa53c51a704d7372c37770aaf275b6",
                "size": null,
                "uploaded_stamp": null
            }
        }
    }
    
    응답은 file과 image로 돌아가는 upload_모든 파일을 URL에 업로드합니다.
    API를 사용하여 파일 업로드
    curl --location --request PUT "https://s3.ap-northeast-1.amazonaws.com/root.bricks.pub/content_files/eafd96f6-0c97-432a-a677-16dc306004ed/1d9338b0-dbd6-4944-8791-c8cfb5a8fda6.pdf?x-amz-acl=private&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJLLXFHCUMKSFOTJA%2F20190327%2Fap-northeast-1%2Fs3%2Faws4_request&X-Amz-Date=20190327T005943Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=22214dd5895bd06cb70df338c1fcbcd63c954643a7c99c4fb9550964b69d6ff6" \
      --data-binary "@assets/book.pdf" -v
    
    API를 사용하여 이미지 업로드
    curl --location --request PUT "https://s3.ap-northeast-1.amazonaws.com/root.bricks.pub/content_images/eafd96f6-0c97-432a-a677-16dc306004ed/7a0c6027-50d5-49fe-8133-3d1dbf2f92cf/default.jpeg?x-amz-acl=public-read&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJLLXFHCUMKSFOTJA%2F20190327%2Fap-northeast-1%2Fs3%2Faws4_request&X-Amz-Date=20190327T005943Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=dfe2e8de69df68d1049e578ebb43b0072bfa53c51a704d7372c37770aaf275b6" \
      --data-binary "@assets/cover.jpg" -v
    

    3. 내용 탐색


    FLB BinB 로그인

    FLB ROOT 계정을 FLB BinB에서 사용할 수 있습니다.

    로그인에 성공했습니다.
    Brick 정보 등록


    API 키 등의 정보를 얻었습니다.
    API를 사용하여 읽기 컨텐츠에 대한 링크 생성
    curl --location --request POST "https://api.binb.bricks.pub/v1/contents/tokens" \
      --header "X-API-KEY: {APIキー}" \
      --header "Content-Type: application/json" \
      --header "X-CONFIRMATION-TOKEN: {Confirmationトークン}" \
      --data "{
      \"content_id\": \"{Content ID}\",
      \"exit_url\": \"{ビューワーを閉じたときに遷移するURL}\",
      \"continuation_url\": \"{最後のページまで読んだあとに遷移するURL}\"
    }"
    
    API를 실행하려면 다음과 같은 정보가 필요합니다.
  • Content ID
  • 방금 API를 통해 등록된 컨텐츠의 ID
  • API 키
  • FLB BinB 콘솔의 Brick 세부 화면에서 확인
  • 표시 확인
  • FLB ROOT 콘솔의 Brick 세부 화면에서 확인
  • ※ 컨텐츠를 읽을 수 없는 경우 API를 사용하여 컨텐츠의 상태를 확인할 수 있습니다.
    https://console.binb.bricks.pub/docs/api/v1#contents-show
    curl --location --request GET "https://api.binb.bricks.pub/v1/contents/{Content ID}" \
      --header "X-API-KEY: {APIキー}" \
      --header "X-CONFIRMATION-TOKEN: {Confirmationトークン}"
    
    읽다

    이번에는 읽기용 링크를 생성하는 API를 사용해 책 뷰어를 표시하는 사이트를 만들었다↓
    https://fl-bricks.shwld.now.sh/
    이번에 만든 서비스 코드는 여기 있습니다.
    https://github.com/shwld/fl-bricks-sample

    좋은 웹페이지 즐겨찾기