reviseFromUrl

This action allows you to publish a new revision of document from a file available on the internet.

info

The API key must have access rights to publish.

Request

Name		Type	Description
apikey	Required	string	API public key
signature	Required	string	Signature of the request.
expires		timestamp	UNIX timestamp for request expiration (GMT)
output		string	Format of the response. Either XML (default), JSON or PHP
book_id	Required	string	ID of the publication
url	Required	string	URL of the document to publish
subscription_id	Required	integer	ID of the folder

Response

This method returns a Publication.

Name	Type	Description
ID	string	ID of the publication
AccountID	integer	Publication's owner account ID (should be your account ID)
SubscriptionID	integer	Publication's owner subscription ID
Description	string	Description of the publication
Status	string	Conversion status of the publication. Either QUEUE (waiting to be converted), PROCESS (processing document), STORE (converting document), ERROR (error during conversion) or DONE (publication ready)
IsPublished	integer	Sends 1 if the publication is published and 0 if not
IsPrivate	integer	Sends 1 if the publication is private and 0 if not
AuthID	string	Authentication parameter for private URLs (authid)
AllowMini	integer	Sends 1 if the publication allows access to the miniCalaméo and 0 if not
Pages	integer	Number of pages of the publication
Width	integer	Width of a page of the publication
Height	integer	Height of a page of the publication
Views	integer	Number of views of the publication
Downloads	integer	Number of downloads of the publication
Comments	integer	Number of comments of the publication
Favorites	integer	Number of favorites from the publication
Date	date	Reference date of the publication
Creation	datetime	Date of creation of the publication
Publication	datetime	Scheduled date of the publication (UTC)
Modification	datetime	Date of the last modification of the publication
PosterUrl	string	Absolute URL for the publication's larger cover
PictureUrl	string	Absolute URL for the publication's cover
ThumbUrl	string	Absolute URL for the publication's thumbnail
PublicUrl	string	Absolute URL for the publication's overview
ViewUrl	string	Absolute URL for the publication's reading page
CommentsUrl	string	Absolute URL for the publication's comments

Example response

JSON

{
  "response": {
    "status": "ok",
    "version": 2,
    "requestid": "TrRptA",
    "requests": 227,
    "content": {
      "ID": "004516825ca65f113d232",
      "SubscriptionID": 4540112,
      "AccountID": 4516825,
      "Name": "Test",
      "Description": "1",
      "Category": "MISC",
      "Format": "MISC",
      "Dialect": "de",
      "Status": "REQUEUE",
      "IsPublished": 1,
      "IsPrivate": 1,
      "AuthID": "nl85OHvgXeKP",
      "AllowMini": 1,
      "Date": "2015-10-16",
      "Pages": 0,
      "Width": 0,
      "Height": 0,
      "Views": 0,
      "Downloads": 0,
      "Comments": 0,
      "Favorites": 0,
      "PosterUrl": "",
      "PictureUrl": "",
      "ThumbUrl": "",
      "PublicUrl": "",
      "ViewUrl": "",
      "Creation": "2015-10-16 11:31:58",
      "Modification": "2015-10-16 11:31:58"
    }
  }
}