The information in this article applies to:

• NewsGator Platform

NewsGator retrieves all feeds on a normal schedule. However, it is possible to request that a feed be updated ad hoc. This is accomplished by calling NewsGator’s ping service. This service can be called after new content has been added to a feed. NewsGator ping service supports REST and XMLRPC.

Subscription or Taxonomy Inclusion Required
There are a few simple requirements that must be met for the ping service to retrieve a feed. At least one user must be subscribed to the feed or the feed must be present in a known taxonomy within the NewsGator system.

Link vs. XmlUrl
Feeds usually provide two distinct URLs, one for the site or page where the feed lives, we refer to it as the Link. The other URL is for the raw feed, we call this one the XmlUrl. This distinction is important because it affects the way our system looks up feed information internally. Basic pings should pass in the Link. Our backend system will use the Link to look up and retrieve content from the XmlUrl.

Title: Greg Reinacker's Weblog
Link: http://www.rassoc.com/gregr/weblog
XmlUrl: http://www.rassoc.com/gregr/weblog/rss.aspx

Basic Ping vs. Extended Ping
This document covers basic ping functionality only. NewsGator does support extended ping functionality via XMLRPC, however since the ultimate result is the same, there is no need to send an extended ping. If you feel an extended ping is absolutely required, please content NewsGator Support for more information.

Ping Service Endpoint: http://services.newsgator.com/ngws/xmlrpcping.aspx
Authentication is not required.

REST
NewsGator supports GET requests only.

Endpoint:             http://services.newsgator.com/ngws/xmlrpcping.aspx

Parameters
[Required]
name:                 Name of the feed
url:                      Link (not XmlUrl)

[Optional]
changesURL:     Link (not XmlUrl)

Examples: http://services.newsgator.com/ngws/xmlrpcping.aspx?name=GregReinacker'sWeblog&url="http://www.rassoc.com/gregr/weblog"

http://services.newsgator.com/ngws/xmlrpcping.aspx?name=”GregReinacker'sWeblog”&url=”http://www.rassoc.com/gregr/weblog”&changesURL=”http://www.rassoc.com/gregr/weblog"

XMLRPC

Endpoint:            http://services.newsgator.com/ngws/xmlrpcping.aspx

Parameters
[Required]
methodName:     weblogUpdates.ping
First value:          Name of the feed
Second value:     Link (not XmlUrl)

Request –

<?xml version="1.0"?>

<methodCall>

     <methodName>weblogUpdates.ping</methodName>

     <params>

           <param>

                <value>Greg Reinacker's Weblog</value>

           </param>

           <param>

                <value>http://www.rassoc.com/gregr/weblog</value>

           </param>

     </params>

</methodCall>

Response –

<?xml version='1.0'?>

<methodResponse>

  <params>

    <param>

      <value>

        <struct>

          <member>

            <name>flerror</name>

            <value><boolean>0</boolean></value>

          </member>

          <member>

            <name>message</name>

            <value>Thanks for the ping.</value>

          </member>

        </struct>

      </value>

    </param>

  </params>

</methodResponse>