I4A API 2.0: Difference between revisions

From i4a API Wiki
Jump to navigation Jump to search
No edit summary
Line 27: Line 27:
=== Contacts Endpoint ===
=== Contacts Endpoint ===
<syntaxhighlight lang="html">
<syntaxhighlight lang="html">
/i4a/api2/contacts/
POST /i4a/api2/contacts/
</syntaxhighlight>
</syntaxhighlight>

Revision as of 13:56, 26 October 2022

Security

For security purposes, I4A API 2 will only work on a secure port through HTTPS. To access any of the API functionality, you must first authenticate. Information is available on the API Settings page on how to obtain the values needed to authenticate and update them, if need be.

REST Authentication

Example:

curl --location --request POST 'https://<yourdomain.com>/i4a/api2/authenticate' \
--form 'username="XXXXXXXX"' \
--form 'password="XXXXXXXX"' \
--form 'token="XXXXXX-XXXX-XXXXX-XXXXXXXXXXX"'

Response:

{
    "expiration": "{ts '2022-10-25 16:03:47'}",
    "success": true,
    "authKey": "XXXXXX-XXXX-XXXXX-XXXXXXXXXXX",
    "error": ""
}


Once you have successfully obtained the authKey, you can then access a few different endpoints.

Contacts Endpoint

POST /i4a/api2/contacts/