Cogblog

The Official Blog of Cogmap, the Org Chart Wiki

 

 

Name-based APIs

UPDATE: All of this has been deprecated: http://www.cogmap.com/blog/2008/07/21/cogmap-api-update-july-2008cogmap-api-update-july-2008/

New features for programmers trying to do things with Cogmap: Name-based map identification! It works like this:

  1. http://www.cogmap.com/nameapi.php?chart=<Name of Company> will return either the map of that page or a page to create a new chart.
  2. http://www.cogmap.com/xoxonameapi.php?chart=<Name of Company> will return either the XOXO XML document of the organization structure of that company or a 404 error.
  3. http://www.cogmap.com/numbernameapi.php?chart=<Name of Company> will return the unique identifier of the chart ID for that company or a 404 error.

Here is an example for Google: http://www.cogmap.com/xoxonameapi.php?chart=Google
This will allow programmers to integrate applications much more easily. If you want to use our chrome and make it easy for people to extend and update maps, just direct them to our pages with nameapi.php. If you are trying to consume Cogdata but want to capture it using names, then xoxonameapi.php will make it easy to access our data structure using only the names of companies.

The name field, because it is editable in the wiki, is a less reliable field than the unique identifier we assign each map. If you want to create static links to specific maps, it is better to use that maps chart ID. If you wanted to spider the site for all the chart IDs and map names, the best way to do that would probably be to consume and parse the alphabetical list: http://www.cogmap.com/alpha.php

For the numbernameapi.php, if a chart exists, it returns the number (CHART ID) of that chart, which could then be used to call the chart page (http://www.cogmap.com/chart.php?id=<CHART ID>) or the XML document (http://www.cogmap.com/xoxo.php?id=<CHART ID>).

Definitely shoot us emails if you build public applications using this. We love to share whatever SEO juice we have.

One Response to “Name-based APIs”

  1. Cogblog Says:

    Cogmap APIs…

    This is a unified post to point to all of our APIs. Each title links to more comprehensive documentation.
    XOXO Organization Charts
    Every Cogmap org chart is available as an XOXO document.
    Organization Chart Data is accessible as an XOXO document by ca…