Additional Integrations

Creating new projects easily

If you want to integrate your software — whether it’s a Mergado platform app (extension) or any other web app — with Mergado by allowing your users to create a new project in Mergado quickly and easily, we offer you a “prefill URL” which navigates the user’s browser to the “new project wizard” page, with the input feed URL, or even additional settings, already filled in:

Minimal version

https://app.mergado.com/new-project/prefill/?url=<feed_url>

With additional options

https://app.mergado.com/new-project/prefill/
?url=<feed_url>
&eshopName=<eshop_name>
&inputFormat=<input_format_id>
&outputFormat=<output_format_id>

GET Parameters Explained

Note: List of supported input and/or output formats and their IDs is a living thing and changes with time. Current list of all format IDs known to Mergado is here. If needed, please consult the Mergado staff.

Styled HTML button

You can use this button/link to lead your users to the URL mentioned above. Minor variations of the styling and the text are possible to fit your needs.

Vytvořit projekt

HTML

<a role="button" class="mergado-prefill-button" href="https://app.mergado.com/new-project/prefill/?url=<feed_url>">
    <svg class="icon" viewBox="0 0 40 40" xmlns="http://www.w3.org/2000/svg">
        <path d="M0 0 L20 20 L0 40 Z" fill="#7FB92F" />
        <path d="M20 20 L40 40 L0 40 Z" fill="#427B27" />
        <path d="M20 20 L40 0 L40 40 Z" fill="#44A8B7" />
    </svg>
    <span>Vytvořit projekt</span>
</a>

<style>
    .mergado-prefill-button {
        width: fit-content;
        display: flex;
        align-items: center;
        gap: 0.5rem;
        font-family: sans-serif;
        font-weight: bold;
        font-size: 12pt;
        border: 2px solid #0c7d3e;
        padding: 10px 20px;
        background: white;
        color: #383632;
        border-radius: 4px;
        cursor: pointer;
        transition: all 0.1s ease;
    }

    .mergado-prefill-button:visited,
    .mergado-prefill-button:active,
    .mergado-prefill-button:hover {
        color: #383632;
        text-decoration: none;
    }

    .mergado-prefill-button .icon {
        height: 20px;
        width: auto;
        transition: filter 0.1s ease;
    }

    .mergado-prefill-button:hover {
        background: #0c7d3e;
        color: white;
    }

    .mergado-prefill-button:hover .icon {
        filter: brightness(0) invert(1);
    }
</style>

Redirect into Mergado Keychain

If you require a connection with one of the services in Mergado Keychain and the user hasn’t connected to Mergado Keychain (connection status you can see on this endpoint), you can redirect from your app to Mergado Keychain to create this connection.

Minimal version

https://app.mergado.com/go/keychain ?eshopId=<eshop_id> &connection=<connection_name>

With additional options

https://app.mergado.com/go/keychain
?eshopId=<eshop_id>
&connectionName=<connection_name>
&callbackUrl=<callback_url>

GET Parameters Explained