da.e.ventures APIDOCs

*Please note all requests must be https and post

api/add_storage

• Required fields:name, description and required switchs according to the given name
• Add few params based on pre-configured names, Available names are:
  • db
  • api
  • s3 bucket
  • post
  • invokable object
  • local (agent_id)
• Switches required accordingly to the storage name given:{"storage_configurations":{"names":{"db":["db_uri","db_table_name","db_field_name","db_insert_sql"],"invokable":["invokable_value",
  "invokable_value"],"post":["post_value"],"api":["api_value"],"get":["get_value"],"s3":["agent_id"],"local":["agent_id"]}}}

• *Please note: when adding digital assets storage_id 93 is already available for use and routes to the local repo

• Returns STORAGE_ID

Example request:

curl -v -XPOST -H "Content-Type: application/json;charset=UTF-8; Cache-Control: no-cache" -d '{"token":"hidden","name":"db","description":"external db example for storage/object factoring","db":1,"db_uri":"{user:'myuser', host:'example.com', port:3306, schema:'main-schema'}","db_table_name":"class_entry","db_field_name":"field","db_insert_sql":"none"}' 'https://da.e.ventures/api/add_storage'

HTTP Request

POST api/add_storage

api/add_source

Required Fields: name,description, type + bitType(s) param according to type

Available bitTypes:

t1 URL (bitTypes required: url, protocol)

t2 Direct Acquiral ( bitTypes required: direct_acquiral_cmd, direct_acquiral_cmd_type )

t3 Listener ( bitTypes required: agent_id )

t4 DB( bitTypes required: db_uri,db_table_name,db_field_name,db_where_clause )

t5 Custom GET request ( bitTypes required: get_request_params )

t6 Custom POST request ( bitTypes required: post_request_params )

t7 Agent ( bitTypes required: agent_id )

{"source_bitTypes_and_flags":{"t1":["url","protocol"],"t2":["direct_acquiral","direct_acquiral_cmd","direct_acquiral_cmd_type"],
"t3":["agent_id"],"t4":["db_uri","db_table_name","db_field_name","db_where_clause"],"t5":["post_request_params","url","protocol"],
"t6":["get_request_params","url","protocol"],"t7":["agent_id"]}}

• Returns SOURCE_ID

curl -v -XPOST -H "Content-Type: application/json;charset=UTF-8; Cache-Control: no-cache" -d '{"token":"hidden","type":"t1","name":"url example","description":"source example, url as digital asset","url":"e.ventures","protocol":"https"}' 'https://da.e.ventures/api/add_source'

HTTP Request

POST api/add_source

api/get_object_current_version

• Required fields: token, da_id
• Get latest version of DigitalAsset in its ASCII format ( so it can be inject from the API into a dependency service container. The ASCII Object representation is based on the chosen language via digital asset BITs ( default is php8.1 and c++ ). If first version is not present, API will acquire content and issue first version. Content will be published.

Example request:

curl -v -XPOST -H "Content-Type: application/json;charset=UTF-8; Cache-Control: no-cache" -d '{"token":"hidden","da_id":1009}' 'https://da.e.ventures/api/get_object_current_version'

HTTP Request

POST api/get_object_current_version

api/acquire_object_new_version

• Required fields: token, da_id
• Issues new version of Digital Asset by assembling its bits from database and acquires&publish content. Returned object is a Class Object in ASCII format based on the chosen language template. ( Default is php8.1 and c++ )

Example request:

curl -v -XPOST -H "Content-Type: application/json;charset=UTF-8; Cache-Control: no-cache" -d '{"token":"hidden","da_id":1009}' 'https://da.e.ventures/api/acquire_object_new_version'

HTTP Request

POST api/acquire_object_new_version

api/get_source_flags_for_all_bittypes

• Get all available source types ( bitTypes )
• Required field: token

HTTP Request

POST api/get_source_flags_for_all_bittypes

Example request:

   curl -v -XPOST -H "Content-Type: application/json;charset=UTF-8; Cache-Control: no-cache" -d '{"token":"hidden"}' 'https://da.e.ventures/api/get_source_flags_for_all_bittypes'

api/get_blueprint_shapes

• Get all available shapes for Blueprints
• Required field: token

Example request:

   curl -v -XPOST -H "Content-Type: application/json;charset=UTF-8; Cache-Control: no-cache" -d '{"token":"hidden"}' 'https://da.e.ventures/api/get_blueprint_shapes'

HTTP Request

POST api/get_blueprint_shapes

api/get_storage_configs

• Required Field: token
• Get available switches for adding Storage

Example request:

curl -v -XPOST -H "Content-Type: application/json;charset=UTF-8; Cache-Control: no-cache" -d '{"token":"hidden"}' 'https://da.e.ventures/api/get_storage_configs'

HTTP Request

POST api/get_storage_configs

api/add_blueprint

Example request:

curl -v -XPOST -H "Content-Type: application/json;charset=UTF-8; Cache-Control: no-cache" -d '{"token":"hidden","source_id":SOURCE_ID,"name":"e.ventures front page","description":"front page as da, auto delta monitoring","site":1}' 'https://da.e.ventures/api/add_blueprint'

Required Fields: name,description, and at least one shape

Available Shapes:

{"blueprint_shapes":["allowed_locally","amp","api","audio","auth_required","avi","bash","binary_content",
"chipboard","code","curl","custom_hardware","delta_needed","development","docker","domain","emulation","encrypted_content",
"file","game_save","git","hard_to_crawl","high_volume","html","image","jpg","linux","mov","mp3","news","nodejs","npm",
"oauth2","php","pi","png","production","public","server","server_side_content","sftp","site","string_content","svg","video",
"virtual_machine","webAssembly","whois","zmodem"]}

• Returns BLUEPRINT_ID

HTTP Request

POST api/add_blueprint

api/add_digital_asset

• Required fields: token, blueprint_id, storage_id, name, description, allowed_locally (bitType/bool),da_email,
• Please use storage_id 93 for local repo (da.e.ventures)

Example request:

curl -v -XPOST -H "Content-Type: application/json;charset=UTF-8; Cache-Control: no-cache" -d '{"token":"hidden","blueprint_id":blueprint_id,"storage_id":storage_id,"name":"e.ventures.front.page","description":"site example","da_email":"the@e.ventures","allowed_locally":1}' 'https://da.e.ventures/api/add_digital_asset'

    

HTTP Request

POST api/add_digital_asset

api/get_blueprint

• Get blueprint record
• Required fields: token, blueprint_id

Example request:

curl -v -XPOST -H "Content-Type: application/json;charset=UTF-8; Cache-Control: no-cache" -d '{"token":"hidden","blueprint_id":blueprint_id}' 'https://da.e.ventures/api/get_blueprint'

HTTP Request

POST api/get_blueprint

api/generate_dataset

• Required fields: token, assembly_id ( collection of DAs )
• Stream for feature engineering

Example request:

curl -X POST \
    "http://localhost/api/get_kci" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json"

HTTP Request

POST api/generate_dataset

api/get_source

• Retrieves Source record
• Required fields: token, source_id

Example request:

curl -v -XPOST -H "Content-Type: application/json;charset=UTF-8; Cache-Control: no-cache" -d '{"token":"hidden","source_id":source_id}' 'https://da.e.ventures/api/get_source'

HTTP Request

POST api/get_source

api/get_storage

• Required field: token
• Retrieves a Storage record

Example request:

curl -v -XPOST -H "Content-Type: application/json;charset=UTF-8; Cache-Control: no-cache" -d '{"token":"hidden","storage_id":storage_id}' 'https://da.e.ventures/api/get_storage'

HTTP Request

POST api/get_storage

api/get_da

• Retrieves a DigitalAsset record
• Required field: token, da_id
• *Please note this retrieves the representation and versions, for actual object factoring please see publishing and agents

Example request:

curl -v -XPOST -H "Content-Type: application/json;charset=UTF-8; Cache-Control: no-cache" -d '{"token":"hidden","da_id":da_id}' 'https://da.e.ventures/api/get_da'

HTTP Request

POST api/get_da

api/get_kci

• Required fields: token, da_id
• Get equivalent KCI for given digital_asset_id (da_id)

Example request:

curl -X POST \
    "http://localhost/api/get_kci" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json"

HTTP Request

POST api/get_kci

api/generate_kci

• Required fields: token, da_id
• Generate KCI for given Digital Asset ID ( da_id )

Example request:

curl -X POST \
    "http://localhost/api/generate_kci" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json"

HTTP Request

POST api/generate_kci

api/publish_da

Example request:

curl -X POST \
    "http://localhost/api/publish_da" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json"

HTTP Request

POST api/publish_da

api/publish_deltas

Example request:

curl -X POST \
    "http://localhost/api/publish_deltas" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json"

HTTP Request

POST api/publish_deltas