Welcome to No-Code Mobile Integration Appdome REST API Using Appdome-DEV Build to Publish REST API

Using Appdome-DEV Build to Publish REST API

Mobile integration life-cycle for SDKs and API integration accelerates release cycles and improves mobile app delivery.
You can automate your mobile integration life-cycle for iOS and Android apps over API through curl commands on Appdome-DEV™.

This Knowledge Base article explains how to use the Appdome-DEV™ API lifecycle workflow to build mobile apps with great mobile integration over curl commands.

We hope you find this knowledge base useful and enjoy using Appdome!

About Appdome-DEV™ Build to Publish API

Appdome-DEV™ helps you integrate your iOS and Android apps with SDKs and APIs from different vendors all in a few minutes. You can setup Build to Publish API with Appdome DEV to automate end-to-end mobile integration lifecycle.

The Build to Publish REST API uses a single request to Upload a new build, Build the desired Fusion Set with customizable overrides, Add Context, Sign and Download the Build app.

Prerequisites for using Appdome-DEV™ Build to Publish API

Appdome account – IDEAL or Higher.
Appdome-DEV access
Mobile App (.ipa for iOS, or .apk for Android)
Appdome DEV access with the build to publish API
Signing Credentials (e.g., signing certificates and provisioning profile)

Note: this article will demonstrate using the API with cURL commands.

How to use Appdome DEV™ Build to Publish REST API

First, Get you API Token, Team’s API Key (if needed) and Fusion Set API key.

The cURL command

The technical composition of the cURL command:

URL	https://fusion.appdome.com/api/v1/lifecycle
Method	POST
Content-Type	multipart/form-data
Headers	Authorization: <API Token>
Payload Format	(in form format): -F app=@<path/to/app/binary> -F fusion_set_id=<Your_Fusion_set_API_Key> -F 'provisioning_profile=@<path/to/provisioning_profile>' (iOS Only) -F 'overrides={<overrides, or empty JSON>}' (see details below) -F 'icon_overlay_content=@<path/to/icon/file>' (optional) -F 'app_customization_application_icon=@<path/to/icon/file>' (optional) -F 'app_customization_application_files=@<path/to/single/file>' (optional) -F 'plugin_good_private_certs_content'=@<path/to/single/file>' (optional) -F 'signing_keystore_auto_gen=@<path/to/single/file>' (optional)
CURL Example	`curl -X POST -H "Authorization:XXXYYYZZZ" -H "content-type: multipart/form-data" https://fusion.appdome.com/api/v1/lifecycle -F app=@~/tmp/app.apk -F fusion_set_id=123abc-456xyz -F 'overrides={}'`
Response	App Binary

How to Use Overrides

The Override JSON can include any of the following customizations (note that some are co-dependant):

Key	Name in Appdome	Value	Notes
`user_agent`	User Agent Customization	Boolean	co-dependent with `user_agent_value`
`user_agent_value`	User-Agent Header	String
`signing_keystore_use_google_signing`	Use Google Play App Signing	Boolean	co-dependent with `signing_keystore_google_signing_sha1_key`
`signing_keystore_google_signing_sha1_key`	App Signing Certificate SHA-1	String
`should_copy_url_to_clipboard`	Copy URL to Clipboard	Boolean
`plugin_good_probe_url`	Pre-Authentication URL	String of up to 1024 characters
`plugin_good_app_version`	GD Entitlement Version	String of up to 250 characters
`plugin_good_app_id`	GD Entitlement ID	String of up to 128 characters
`icon_overlay`	Add Favicon	Boolean	co-dependent with `icon_overlay_scale, icon_overlay_position, icon_overlay_filename`
`icon_overlay_scale`	Scale	Number between 20 and 50
`icon_overlay_position`	Favicon Position	‘Top Right’, ‘Top Left’, ‘Bottom Right’, ‘Bottom Left’
`icon_overlay_filename`		String
`extended_logs`	Extended Logs	Boolean	Only if enabled for the user.
`extended_logs_gesture_via_http`	Tap to upload logs(iOS)/ Shake to upload logs(Android)	Boolean	co-dependent with `extended_logs`
`extended_logs_gesture_via_external_app`	Tap to email logs(iOS)/ Shake to email logs(Android)	Boolean	co-dependent with `extended_logs`
`customize_url_enable`	Private URL	Boolean	co-dependent with `customize_url_value, customize_url_key`
`customize_url_value`	Private URL Value	String
`customize_url_key`	Private URL Identifier	String
`app_customization_private_certs`	Private Server Certificates and Authorities	Boolean
`app_customization_pack_bundle_version`	App Version	String
`app_customization_pack_bundle_identifier`	App Bundle ID	String
`app_customization_pack_bundle_display_name`	App Display Name	String
`app_customization_pack_bundle_build_number`	App Version Code	Number
`app_customization_key_value_list`	Custom Values	Object
`app_customization_application_icon_filename`		String
`anti_pharming_url_list`	URL List	Array of Strings
`preauth_trigger_list plugin_okta_trigger_listProtected plugin_ping_trigger_list plugin_apm_trigger_list plugin_adal_trigger_list plugin_azure_trigger_list plugin_adfs_trigger_list plugin_ntlm_trigger_list plugin_microsoft_app_proxy_trigger_list`	Protected Resource	Array of Strings (URL)	Match to authentication method in the Fusion set
`signing_keystore_password`	Singing Android: Keystore password	String
`signing_keystore_alias`	Singing Android: Keystore alias	String
`signing_keystore_key_password`	Singing Android: Key password	String

How Do I Learn More

Check out Appdome Platform, Appdome-DEV, or request a demo at any time.

If you have any questions, please send them our way at support@appdome.com or via the chat window on the Appdome platform.

Thank you!

Thanks for visiting Appdome! Our mission is to make mobile integration easy. We hope we’re living up to the mission with your project. If you don’t already have an account, you can sign up for free.

Appdome-DEV

Last updated by

Nitzan Posener