2.5 Application Registration

To have your application recognized and activated within Retailys, you must register the Application Manifest with the core. Two main methods exist:

1. Public API Call: Send a POST request to https://core.retailys.com/apps/register?url=manifestUrl with a parameter manifestUrl that points to your manifest’s XML file. The core then:

   • Fetches your XML manifest.

   • Validates it against the Manifest Blueprint.

   • Calls your app’s enroll method.

   • Marks the app as active in the internal database, if successful.

Important notes:

• Ensure your manifest URL is publicly accessible and uses valid HTTPS.

• If using a custom domain or hosting, verify your SSL certificate is valid and recognized.

• When you update your manifest (e.g., increment the app version, add new fields), you typically trigger re-registration so the core can re-validate and reload definitions.