.. _info-ios:

============
IOS settings
============


Verification
-------------

If the verification feature is enabled, it is possible to send a request for IOS
verification via |automation| API.

verification feature can be enabled by the Account Manager per client account.

.. note::
    Verification is done synchronously and request is waiting for a response from
    Adjust Verification service before continuing to handle the incoming request.
    This could add overhead to standard requests.

The process under the hood looks like this::

    User Request POST /app
    ==> Create App in Adjust
    ==> Send Request To Verification Tool
    ==> Receive Response from Verification Tool
    ==> Continue processing user request (migrating data the from Template to the app)

.. warning::
    This feature is **disabled** by default.

    If the request has ``"verification": true`` parameter set in the body for
    account which doesn't have verification enabled - |automation| API will
    return **400 status** with an explanation.

It's not possible to remove verification for an app via Automation API.
To achieve this please contact Adjust Account manager.

In the body request the parameter has a view: ``{"verification": true}``.
It is possible to send ``false/null`` values but it will not have any effect.

Example:

.. code-block:: bash

    $ curl \
    --header "AdjustAuthorization: Token " \
    --header "Content-Type: application/json" \
    --data '{
        "name":"Test App Name",
        "bundle_id":"test.bundle.app",
        "store_id":"123456789",
        "platform":"ios",
        "verification": false
    }' \
    -X POST https://settings.adjust.com/api/app

To validate that the verification was successful every response contains the
nullable parameter ``sk_app_id`` which will be filled with a value if the
verification has been done.

Possible response:

.. code-block:: bash

    {"sk_app_id": "123456789", ...}


SKAd Network configuration
--------------------------

SKAd Network configuration migration has to be enabled as separate feature per
each account on |automation|.

Even if the app is not verified SKAd Network configuration will be migrated to the
:term:`Destination app`.


iOS Purchase Verification
-------------------------

It is possible to specify iOS purchase verification per app by using optional body attribute
in the `POST /app` endpoint, see :ref:`post-app`

Example:

.. code-block:: bash

    $ curl \
    --header "AdjustAuthorization: Token " \
    --header "Content-Type: application/json" \
    --data '{
        "name":"Test App Name",
        "bundle_id":"test.bundle.app",
        "store_id":"123456789",
        "platform":"ios",
        "ios_pv_shared_secret": "QWERTY"
    }' \
    -X POST https://settings.adjust.com/api/app