Issues

API for managing issues

get
List Issues

https://www.magloft.com/api/portal/v1/issues/:app_id
This endpoint returns a list of all issues that belong to the magazine
Request
Response
Path Parameters
app_id
required
String
App ID (Publication) to scope this request for.
Query Parameters
url_scheme
optional
string
URL scheme for the issue assets. The value can be one of the following: path (default): /path/to/asset shorthand: //cdn_host/path/to/asset https: https://cdn_host/path/to/asset http: http://cdn_host/path/to/asset
source
optional
String
Source type of issue
200: OK
{
"id": 1234,
"title": "Welcome to MagLoft",
"info": null,
"hpub": null,
"source_file": null,
"source": "typeloft",
"unlock_type": "free",
"categories": null,
"product_id": "purchase.issue_123456789",
"product_id_apple": null,
"product_id_google": null,
"publication_id": null,
"coupon_code": null,
"dirty": false,
"user_id": null,
"custom_stylesheet": null,
"custom_data": null,
"price_tier": null,
"cover": null
}

get

https://www.magloft.com/api/portal/v1/issues/:app_id
Request
Response
Query Parameters
url_scheme
optional
string
`https`: https://host/path/to/asset
200: OK

get

https://www.magloft.com/api/portal/v1/issues/:app_id
Request
Response
Query Parameters
url_scheme
optional
string
//host/path/to/asset
200: OK

get
Retrieve paginated list of issues

https://www.magloft.com/api/portal/v1/issues/:app_id/page/:page
This endpoint returns a page list of all issues that belong to the magazine
Request
Response
Path Parameters
app_id
required
String
App ID (Publication) to scope this request for.
page
required
Integer
The page number to list
Query Parameters
per_page
optional
Integer
Number of items to show per page
order_by
optional
Symbol
Field to sort results by
order_dir
optional
Symbol
Direction (asc, desc) to sort results by
filter
optional
String
Text filter to search results by
200: OK
{
"total": 1,
"page": 1,
"records": [
{
"id": 1234,
"title": "Welcome to MagLoft",
"info": null,
"hpub": null,
"source_file": null,
"source": "typeloft",
"unlock_type": "free",
"categories": null,
"product_id": "purchase.issue_123456789",
"product_id_apple": null,
"product_id_google": null,
"publication_id": null,
"coupon_code": null,
"dirty": false,
"user_id": null,
"custom_stylesheet": null,
"custom_data": null,
"price_tier": null,
"cover": null
}
]
}

get
Get Issue

https://www.magloft.com/api/portal/v1/issues/:app_id/:id
This endpoint returns a specific issue by id
Request
Response
Path Parameters
app_id
required
String
App ID (Publication) to scope this request for.
id
required
Integer
Issue ID
200: OK
{
"id": 1234,
"title": "Welcome to MagLoft",
"info": null,
"hpub": null,
"source_file": null,
"source": "typeloft",
"unlock_type": "free",
"categories": null,
"product_id": "purchase.issue_123456789",
"product_id_apple": null,
"product_id_google": null,
"publication_id": null,
"coupon_code": null,
"dirty": false,
"user_id": null,
"custom_stylesheet": null,
"custom_data": null,
"price_tier": null,
"cover": null
}

get
Download Issue

https://www.magloft.com/api/portal/v1/issues/:app_id/:id/download
This endpoint redirects to a specific issue HPUB url
Request
Response
Path Parameters
app_id
required
String
App ID (Publication) to scope this request for.
id
required
Integer
Issue ID
200: OK
null

get
Download a specific issue source

https://www.magloft.com/api/portal/v1/issues/:app_id/:id/source
This endpoint redirects to a specific issue source file url
Request
Response
Path Parameters
app_id
required
String
App ID (Publication) to scope this request for.
id
required
Integer
Issue ID
200: OK
null

post
Create an Issue

https://www.magloft.com/api/portal/v1/issues/:app_id
This endpoint creates a new issue and returns the saved issue
Request
Response
Path Parameters
app_id
required
String
App ID (Publication) to scope this request for.
Body Parameters
user_id
optional
Integer
Issue User ID
title
optional
String
Issue Title
info
optional
String
Issue information
date
optional
String
Issue publish date
product_id
optional
String
Issue product id
product_id_apple
optional
String
Issue product id (Apple)
product_id_google
optional
String
Issue product id (Google)
unlock_type
optional
String
Unlock Type
price_tier
optional
Integer
Issue price tier
design_id
optional
Integer
Issue typeloft theme id
cover
optional
String
Issue Cover
hpub
optional
String
Issue HPUB Path
source_file
optional
String
Issue Source File
source
optional
String
Source type of issue
categories
optional
Array
Issue categories
properties
optional
Hash
Issue properties
status
optional
Symbol
create_pages
optional
boolean
publish
optional
boolean
200: OK
{
"id": 1234,
"title": "Welcome to MagLoft",
"info": null,
"hpub": null,
"source_file": null,
"source": "typeloft",
"unlock_type": "free",
"categories": null,
"product_id": "purchase.issue_123456789",
"product_id_apple": null,
"product_id_google": null,
"publication_id": null,
"coupon_code": null,
"dirty": false,
"user_id": null,
"custom_stylesheet": null,
"custom_data": null,
"price_tier": null,
"cover": null
}

put
Update an Issue

https://www.magloft.com/api/portal/v1/issues/:app_id/:id
This endpoint updates a specific issue by id and returns the updated issue
Request
Response
Path Parameters
app_id
required
String
App ID (Publication) to scope this request for.
id
required
Integer
Issue ID
Body Parameters
title
optional
String
Issue Title
info
optional
String
Issue information
date
optional
String
Issue publish date
product_id
optional
String
Issue product id
product_id_apple
optional
String
Issue product id (Apple)
product_id_google
optional
String
Issue product id (Google)
unlock_type
optional
String
Unlock Type
price_tier
optional
Integer
Issue price tier
cover
optional
String
Issue Cover
hpub
optional
String
Issue HPUB Path
source_file
optional
String
Issue Source File
source
optional
String
Source type of issue
categories
optional
Array
Issue categories
status
optional
Symbol
custom_data
optional
Hash
Custom Data Hash
properties
optional
Hash
Issue properties
200: OK
{
"id": 1234,
"title": "Welcome to MagLoft",
"info": null,
"hpub": null,
"source_file": null,
"source": "typeloft",
"unlock_type": "free",
"categories": null,
"product_id": "purchase.issue_123456789",
"product_id_apple": null,
"product_id_google": null,
"publication_id": null,
"coupon_code": null,
"dirty": false,
"user_id": null,
"custom_stylesheet": null,
"custom_data": null,
"price_tier": null,
"cover": null
}

post
Clone an Issue

https://www.magloft.com/api/portal/v1/issues/:app_id/:id/clone/:magazine_id
This endpoint creates a new issue by cloning an existing issue and returns the saved issue
Request
Response
Path Parameters
app_id
required
String
App ID (Publication) to scope this request for.
id
required
Integer
Issue ID
magazine_id
optional
Integer
Cloned Issue target magazine ID
Body Parameters
user_id
required
Integer
Issue User ID
cloneTitle
required
String
Cloned Issue title
200: OK
{
"id": 1234,
"title": "Welcome to MagLoft",
"info": null,
"hpub": null,
"source_file": null,
"source": "typeloft",
"unlock_type": "free",
"categories": null,
"product_id": "purchase.issue_123456789",
"product_id_apple": null,
"product_id_google": null,
"publication_id": null,
"coupon_code": null,
"dirty": false,
"user_id": null,
"custom_stylesheet": null,
"custom_data": null,
"price_tier": null,
"cover": null
}

put
Convert Issue

https://www.magloft.com/api/portal/v1/issues/:app_id/:id/convert
This endpoint converts an issue from PDF, EPUB or Folio
Request
Response
Path Parameters
app_id
required
String
App ID (Publication) to scope this request for.
id
required
Integer
Issue ID
200: OK
{
"id": 1234,
"title": "Welcome to MagLoft",
"info": null,
"hpub": null,
"source_file": null,
"source": "typeloft",
"unlock_type": "free",
"categories": null,
"product_id": "purchase.issue_123456789",
"product_id_apple": null,
"product_id_google": null,
"publication_id": null,
"coupon_code": null,
"dirty": false,
"user_id": null,
"custom_stylesheet": null,
"custom_data": null,
"price_tier": null,
"cover": null
}

put
Pack an issue to HPUB

https://www.magloft.com/api/portal/v1/issues/:app_id/:id/pack
This endpoint pack an issue to HPUB and returns the issue
Request
Response
Path Parameters
app_id
required
String
App ID (Publication) to scope this request for.
id
required
Integer
Issue ID
200: OK
{
"id": 1234,
"title": "Welcome to MagLoft",
"info": null,
"hpub": null,
"source_file": null,
"source": "typeloft",
"unlock_type": "free",
"categories": null,
"product_id": "purchase.issue_123456789",
"product_id_apple": null,
"product_id_google": null,
"publication_id": null,
"coupon_code": null,
"dirty": false,
"user_id": null,
"custom_stylesheet": null,
"custom_data": null,
"price_tier": null,
"cover": null
}

put
Process Filename

https://www.magloft.com/api/portal/v1/issues/:app_id/:id/process_links
This endpoint process an issue filename links in TypeLoft Pages and returns an empty response with status 204
Request
Response
Path Parameters
app_id
required
String
App ID (Publication) to scope this request for.
id
required
Integer
Issue ID
200: OK
null

delete
Delete Issue

https://www.magloft.com/api/portal/v1/issues/:app_id/:id
This endpoint deletes a specific issue by id and returns an empty response with status 204
Request
Response
Path Parameters
app_id
required
String
App ID (Publication) to scope this request for.
id
required
Integer
Issue ID
200: OK
null