https://api.osbn.io/v1/post.phpThe post REST API endpoint allows you to apply for an OSBN by making a POST request. Note that this method can accept all possible record fields except for author image and cover image. A different request method (postimages) is required to submit an author image and/or a cover image.
Request Parameters:
Required
Optional
Example 1: cURL Command (using data file):
data.json:
{
"bookCountry":"Costa Rica",
"title":"The Book of Arne",
"subtitle":"A Short European Literary Exposition",
"author":"Arne Hemingway",
"description":"With a wicked blend of wit and humor, these sixteen disparate and embellished stories of the Americas and Europe are a veritable
literary escapade interspersed with hilarious anecdotes, incisive observations, and thoughtful reflections. All are one hundred percent
true fiction. All sales are final....",
"pages":"204",
"publication_date":"2023-10-04",
"edition":"1",
"format":"paperback",
"genre":"Literary Fiction",
"genre2":"Eclectic, Short Stories",
"book_language":"English",
"price":"14.14",
"currency":"€",
"availability":"In Stock",
"link1name":"Buy",
"link1":"https://www.lulu.com/shop/arne-hemingway/the-book-of-arne/paperback/product-744n5m.html",
"link2name":"Author Site",
"link2":"https://arnehemingway.com/books/TheBookOfArne/",
"message":"Goodbye, cruel world!",
"publisher_name":"AHEM Books",
"publisher_url":"https://arnehemingway.com",
"publisher_contact_name":"Arne Hemingway",
"publisher_contact_email":"arne@arnehemingway.com",
"publisher_description":"A small boutique publisher nestled amongst the Himalayan mountaintops.",
"author_description":"A restless orphan, Arne Hemingway spent his childhood working on his uncle's farm. He longed to
leave and become a fighter pilot but he lacked the means. Also, he was needed on the farm. Then in his 20s, the
innocent act of acquiring two droids from a group of Jawas resulted in his his aunt and uncle's murder. He found himself
on a mission to rescue the droids' owner, who was also a beautiful princess, and destroy the Evil Empire's Death Star.
Hemingway completed the mission successfully by exploiting an exhaust port defect that quite frankly should have been
caught in the first round of security testing.
Mission accomplished, the reclusive Hemingway settled in Europe to write medium-quality short stories, and to continuously
labor over the first pages of several different novels, all still unfinished.",
}
curl -X POST https://api.osbn.io/v1/post.php -H "Authorization: Wmp6ADsd8PtWfMODoaYMXNHIjhHA5Ws" -H "Content-Type: application/json" -d @data.json
Example 2: cURL Command (with minimum required data, test mode):
Command:
curl -X POST https://api.osbn.io/v1/post.php \
-H "Authorization: Wmp6ADsd8PtWfMODoaYMXNHIjhHA5Ws" \
-H "Content-Type: application/json" \
-H "Testing: true" \
-d "{\"bookCountry\":\"Cambodia\",\"title\":\"Exterminating Common Pests\",\"description\":\"By simply using clubs and knives and well as common household poisons, you can quickly and permanently rid your home of a variety of household pests, including kittens, puppies, recalcitrant teens, and door-to-door salesmen.The accuracy of this material is not guaranteed. All sales are final.\",\"author\":\"Arne Hemingway\",\"pages\":\"454\",\"publicationDate\":\"2019-01-01\",\"edition\":\"1\",\"format\":\"hardcover\",\"genre\":\"09\",\"bookLanguage\":\"English\",\"publishedBy\":\"AHEM Books\"}"Responses:
Response Example (Success):
{
"status":"success",
"message":"POST Success!",
"osbn":"OSBN-01-001-000001-001-4"
}
Response Example (Success (testing mode)):
{
"status":"success",
"message":"POST Success!",
"osbn":"OSBN-01-001-000001-001-4",
"Testing":"TRUE"
}
Response Example (Duplicate):
{
"status":"error",
"message":"Duplicate record found."
}
Response Example (Missing required field(s)):
{
"status":"error",
"message":"Missing required fields: bookCountry,pages"
}