Using HTTPS to POST Files

Most items registered with us are submitted via HTTPS POST. When files are POST-ed to our system they are added to a submission queue to await processing.

Submission limits

We have a 10,000 per-user pending submission limit in place, if there are 10,000 submissions in our queue for a given user subsequent uploads will fail with a 503 error. You may resume POST-ing when pending submissions are below 10,000.

Submitting files

Uploading files (for deposit or for bulk queries) are submitted using HTTPs POST with the encType: multipart/form-data. The URL for all submissions is https://doi.crossref.org/servlet/deposit. You may also POST submissions to our test system using https://test.crossref.org/servlet/deposit.

The following parameters are supported:

Form Field	Description	Possible Values	Mandatory	Default
operation	Depends on submission type	doMDUpload: For metadata (XSD) submissions doDOICitUpload: For DOI citations or resources submissions doQueryUpload: For query submissions doDOIQueryUpload: For DOI-to-metadata query submissions	NO	doMDUpload
subType	subtype for metadata submissions	cm: for conflict management submissions	NO	N/A
login_id	Crossref supplied login	N/A	YES	N/A
login_passwd	Crossref supplied password	N/A	YES	N/A
Content parts
fname	Submission contents	N/A	YES	N/A

Sample transactions

Examples using curl:

To upload a file:

curl -F 'operation=doQueryUpload' -F 'login_id=USERNAME' -F 'login_passwd=PASSWORD' -F 'fname=@FILENAME' https:// doi.crossref.org/servlet/deposit

To read from stdin:

curl -F 'operation=doQueryUpload' -F 'login_id=USERNAME' -F 'login_passwd=PASSWORD' -F 'fname=@-' https:// doi.crossref.org/servlet/deposit

Example of a HTTPS transaction:

POST https://doi.crossref.org/servlet/deposit?operation=doMDUpload&login_id=USER&login_passwd=PSWD HTTP/1.1 Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, */* Accept-Language: en-us Content-Type: multipart/form-data; boundary=---------------------------7d22911b10028e User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; Q312461) Host: Myhost Content-length: 1304 Pragma: no-cache -----------------------------7d22911b10028e Content-Disposition: form-data; name="fname"; filename="crossref_query.xml" <?xml version="1.0" encoding="UTF-8"?> <doi_batch version="4.3.0" xmlns="http://www.crossref.org/schema/4.3.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.crossref.org/schema/4.3.0 http://www.crossref.org/schemas/crossref4.3.0.xsd"> <head> ... </head> <body> <journal> .... </journal> </body> </doi_batch> -----------------------------7d22911b10028e--

For backward compatibility, the Crossref system also accepts the login_id, login_passwd, operation, and area parameters in a multi-part request:

-----------------------------7d22911b10028e Content-Disposition: form-data; name="login_id" atypon -----------------------------7d22911b10028e Content-Disposition: form-data; name="login_passwd" _atypon_ -----------------------------7d22911b10028e Content-Disposition: form-data; name="fname"; filename="hisham.xml"

... file contents ...

Articles in this section

Comments