Fargo and naming/storage systems

This post explains how Fargo 2 connects with the naming system.

There are three points of connection, two for the Name Outline command in the File menu, and one for the rendering process in the CMS.

This documentation is here so you can see how the process works. Don't call these endpoints, they're just for Fargo to call. Thanks.

1. Is the name available?

  • URL: http://namer.smallpicture.com/ajax/isNameAvailable

  • Param: name, a string

  • Returns: An HTML snippet suitable for display saying whether the name is available.

2. Grab this name

  • URL: http://namer.smallpicture.com/ajax/newOutlineName

  • Params: url of the associated OPML file, name, both strings

  • Returns: JSON struct indicating whether it worked.

  • Note: It's a JSONP call, the routine name is getData.

3. This outline updated

  • URL: http://fargoajaxsupport.smallpicture.com/ajax/pingPackage

  • Params: url, a string

  • Returns: Nothing worth looking at (at this time).

  • Note: The URL is what was returned by the grab this name call. The OPML file must contain a <head> element, linkHosting, that points to a package file. You can see what one looks like in the #hosting folder of the Fargo app folder.

  • More docs will be forthcoming, for sure.


Last built: Mon, Oct 13, 2014 at 6:48 AM

By Dave Winer, Monday, January 6, 2014 at 3:08 PM. All baking done on premises.