API design for document conversion service
Previous posts:
API
Here's an initial API design. To keep things simple with this version:
- No multipart forms; Upload
base64encoded input documents. - Assign a random
user_idto new users. This ID will be required for theconvert/and/jobsendpoints
| Endpoint | Method | Description |
|---|---|---|
user/new/ |
PUT | Returns a unique random ID. No authentication for now. |
upload/ |
PUT | Upload an input document. Returns document ID. |
convert/ |
PUT | Convert input document to text and/or XML. Returns Job ID. |
jobs/ |
GET | Returns status of previous jobs |
| `jobs/[JOB_ID]/[txt | xml]` | GET |