4 ms·
Not saying it's a good or bad api - but it's not restful I've had a quick go at redesigning it to be more restful. Not perfect, but better i think. Would like
by elborracho 12y ago
Not saying it's a good or bad api - but it's not restful
I've had a quick go at redesigning it to be more restful.
Not perfect, but better i think. Would like to hear others opinion.
/sessions [POST|DELETE]: Open|Close a API session
Certificate Authority management
/cas [GET]: Get a list of all CAs in your account
/cas/{caId} [GET]: Get further details on a given CA
/cas/{caId}/cert [GET]: Download the CA's certificate
/cas/{caId} [DELETE]: Delete a given CA
/cas [POST]: Create a new CA
Certificate management
/cas/{caId}/certs [GET]: Get a list of all certificates for a given CA
/cas/{caId}/certs/{certId}/details [GET]: Get further details on a given certificate
/cas/{caId}/certs/{certId} [GET]: Download the certificate
/cas/{caId}/certs/{certId}/sigreqs [POST]: signing request
/cas/{caId}/certs/{certId}/private-key [GET]: private key for a certificate
/cas/{caId}/certs/{certId} [put]: Re-issue an existing certificate
/cas/{caId}/certs/{certId}/status [put]: Change certificate status
/cas/{caId}/certs [POST]: Create a new certificate
- ExpiredLink 12y ago> but it's not restful Absolutely mandatory comment on each REST API discussion!
- elborracho 12y agoAgreed :) I tried to be constructive at the same time though
- kolev 12y agoAgreed. I got so happy about the news that I didn't even check the API itself.
- shdon 12y agoIndeed. It is misnamed (and I'm the one who did the misnaming, I'll take the blame for it). As it stands, it is a bit of a hybrid. Your version (which is similar to what I had considered, actually) would be relatively easy to map onto the backend. I'll bear this in mind for a future revision. No promises, though.