GET STARTED

Depository is an API driven temporary storage service for JSON and form data. Please read the documentation below to get started.

API URL: https://depository.io/api
Endpoints
/create

Use this endpoint to get your depository id and token. Make sure you keep the token secret as it will allow you to withdraw and delete your data.

Query Parameters

  • email - provide an email to link all your depositories (optional)
  • expire - a valid date/time format to expire your depository (optional, default: one day)

Returns (Object)

  • id - the depository id
  • token - the secret token used for administrative requests
  • deposit_url - the public url used for collecting data
  • stats_url - view the number of collected deposits
  • withdraw_url - get an array of all collected deposits
  • delete_url - delete the deposits associated with the depository id
  • expire - the exact date and time when the depository will not accept new deposits
/deposit/{id}

This is the public endpoint to use when collecting data. You can pass data to this endpoint through query parameters (GET) or JSON data (POST). This can also be included in the action attribute of form elements. Any data provided through the listed methods will be accepted until the depository expires or is deleted.

Returns (Object)

  • id - the deposit id
/stats/{id}/token/{token}

Returns (Object)

  • count - the number of deposits currently stored
/withdraw/{id}/token/{token}

Use this endpoint to withdraw all the deposit data for the provided depository id.

Returns (Array[Object, ...])

  • id - the deposit id
  • data - the raw data stored
  • created_at - the deposit time
/delete/{id}/token/{token}

Use this endpoint to delete the provided depository id. In order to prevent accidental deletion, you must call this endpoint using the DELETE method.

Returns (Object)

  • deleted - state of the delete request (boolean)
TERMS AND CONDITIONS
  • Any data stored will not be shared with any external services or third parties.
  • The data stored for expired depositories will be automatically deleted after one month. If the user manually calls the delete endpoint then the deposits will be deleted instantly.
  • For each depository created, an IP will also be recorded to prevent abuse and inappropriate use.
  • The owners shall not be held responsible or liable for any loss or damage suffered by using this service.