Our webservice for fetching material from the Partner channel service is built around simple GET/POST requests over HTTP. The response is XML and HTTP status codes.
In order to use the service, you need your unique key. You will use this key in all requests for authentication. You can find your unique key, and the ID of your respective channels when you log in at http://www.mynewsdesk.com/partner.
If you don't have a partner account, you can register one here: http://www.mynewsdesk.com/partner/signup.
To list your channels, including channel ID, this root URL is used:
http://www.mynewsdesk.com/partner/api/1_0/unique key/channel
To access material in a channel, the following URL is used:
http://www.mynewsdesk.com/partner/api/1_0/unique key/channel/channel ID/material/service/?parameter=value¶meter=value
http://www.mynewsdesk.com/partner/api/1_0/unique key/channel/channel ID|all*/material/list/?[type_of_media=pressreleases|news|blog_posts|events|images|videos|documents|contact_people]&[start_at=YYYY-MM-DD HH:MM]&[end_at=YYYY-MM-DD HH:MM]&[source_id=id|meta_key=id|organization_number=org-nr]&[limit=limit]&[offset=offset]&[format=rss|xml]&[order=published|updated|created]
HTTP GET request.
XML over HTTP. Status code "200 OK" on successful request. Status code "400 Bad Request" if invalid parameters were used.
Fetch material of this type only.
Only fetch material created after the given time.
Only fetch material created before the given time.
Specify a Mynewsdesk company ID to list only material from that company.
Specify your meta key to list only material from the matching company.
Specify organization number to list only material from the matching company.
Set the maximum number of items in the response. This cannot be more than 100.
Specify which item (sequentially) should be first, skipping preceding items. Note! This must be used in combination with limit.
Specify the sort order of the result: publish date (published), latest update (updated) or creation date (created).
Specify the format of the response: RSS 2.0 or full XML. The RSS feed contains fewer fields than the full XML feed, because of limitations of the format. Read more about RSS 2.0 on Wikipedia.
* Specify "all" instead of channel ID to list material from all your channels. New
** Only one parameter marked by two asterisks is allowed.
http://www.mynewsdesk.com/partner/api/1_0/unique key/channel/channel ID/material/view/?[item_id=id]&[type_of_media=pressrelease|news|blog_post|event|image|video|document|contact_person]
HTTP GET request.
XML over HTTP. Status code "200 OK" on successful request. Status code "404 Not Found" if the material could not be found. Status code "400 Bad Request" if invalid parameters were used.
ID of the material to be fetched.
The type of material to be fetched.
http://www.mynewsdesk.com/partner/api/1_0/unique key/channel/channel ID|all/material/test_list/?[type_of_media=pressreleases|news|blog_posts|events|images|videos|documents|contact_people]&[limit=limit]&[format=rss|xml]&[order=published|updated|created]
Use this method to test your implementation, if your channel is empty. It returns recently published material on Mynewsdesk, independently of your channel.
HTTP GET request.
XML over HTTP. Status code "200 OK" on successful request. Status code "404 Not Found" if the material could not be found. Status code "400 Bad Request" if invalid parameters were used.
The type of material to be fetched.
Set the maximum number of items in the response. This cannot be more than 100.
Specify the format of the response: RSS 2.0 or full XML. The RSS feed contains fewer fields than the full XML feed, because of limitations of the format. Read more about RSS 2.0 on Wikipedia.
http://www.mynewsdesk.com/partner/api/1_0/unique key/channel/channel ID/material/test_view/?[type_of_media=pressrelease|news|blog_posts|event|image|video|document|contact_person]
Use this method to test your implementation, if your channel is empty. It returns recently published material on Mynewsdesk, independently of your channel.
HTTP GET request.
XML over HTTP. Status code "200 OK" on successful request. Status code "404 Not Found" if the material could not be found. Status code "400 Bad Request" if invalid parameters were used.
ID of the material to be fetched.
The type of material to be fetched.
http://www.mynewsdesk.com/partner/api/1_0/unique key/channel/channel ID/pressroom/list/
HTTP GET request.
XML over HTTP. Status code "200 OK" on successful request. Status code "400 Bad Request" if invalid parameters were used.
http://www.mynewsdesk.com/partner/api/1_0/unique key/channel/channel ID/pressroom/view/?[pressroom_id=id]
HTTP GET request.
XML over HTTP. Status code "200 OK" on successful request. Status code "404 Not Found" if the material could not be found. Status code "400 Bad Request" if invalid parameters were used.
ID of the pressroom to be fetched.