The Dogtag PKI project is a long  lived project.  It is a Java Web Server based application that predates many of the technologies that now are standards of Java Web development.  One requirement that has changed over time is how to access the server remotely.

The Remote API for Dogtag is currently an extension of the Web UI:  for the most part, go to the same URL, do the same thing, but add a parameter that indicates you want the response back as XML.  We are looking at making the API more regular,  more understandable and less surprising.

Our current thinking is posted Here:  This page will likely morph significantly over time.

This is a work in progress, and a very recent pass at it.

Yes, we are thinking REST.  It is likely that JSON is going to be a first pass for a marshalling mechanism, but we have some demand for XML as well:  we hope to support both with a single code base.

Since the Wiki doesn’t have a comment board on it, please post your comments here or email them to me and I’ll make sure they are included in the conversation.