{"id":28804,"date":"2026-02-19T16:35:34","date_gmt":"2026-02-19T14:35:34","guid":{"rendered":"https:\/\/aivie.ch\/faq\/miten-voin-luoda-yhteydenoton-apin-kautta-aivieen\/"},"modified":"2026-02-19T16:38:37","modified_gmt":"2026-02-19T14:38:37","slug":"miten-voin-luoda-yhteydenoton-apin-kautta-aivieen","status":"publish","type":"faq","link":"https:\/\/aivie.ch\/fi\/faq\/miten-voin-luoda-yhteydenoton-apin-kautta-aivieen\/","title":{"rendered":"Miten voin luoda yhteydenoton API:n kautta Aivieen?"},"content":{"rendered":"\n<p>Lyhyesti sanottuna: Voit luoda yhteydenoton Aivieen helposti REST API:n kautta l\u00e4hett\u00e4m\u00e4ll\u00e4 POST-pyynn\u00f6n p\u00e4\u00e4tepisteeseen <code>\/api\/contacts\/new<\/code> ja tunnistautumalla Basic Auth- tai OAuth2-tunnistautumisen avulla.<\/p>\n\n<!--more-->\n\n<h2 class=\"wp-block-heading\">Luo yhteyshenkil\u00f6 API:n kautta<\/h2>\n\n<p>Voit luoda uuden yhteystiedon API-p\u00e4\u00e4tepisteen avulla:<\/p>\n\n<pre class=\"wp-block-code\"><code>POST \/api\/contacts\/new\n<\/code><\/pre>\n\n<p>Yksinkertainen esimerkki <code>curl<\/code> n\u00e4ytt\u00e4\u00e4 seuraavalta:<\/p>\n\n<pre class=\"wp-block-code\"><code>curl --location 'https:\/\/aivie-v6.0.ddev.site\/api\/contacts\/new' \\\n--header 'Authorization: Basic VVNF***==' \\\n--header 'Content-Type: application\/json' \\\n--data-raw '{\n    \"email\": \"aivie@dev.ch\",\n    \"firstname\": \"aivie\"\n}'\n<\/code><\/pre>\n\n<p>T\u00e4rke\u00e4\u00e4:<\/p>\n\n<ul class=\"wp-block-list\">\n<li>Pyynt\u00f6 on l\u00e4hetett\u00e4v\u00e4 osoitteessa <code>POST<\/code>.<\/li>\n\n\n\n<li>Tunnistautuminen tapahtuu joko <strong>Basic Auth- tai<\/strong> <strong>OAuth2-<\/strong>tunnistautumisen avulla <strong>.<\/strong><\/li>\n\n\n\n<li>Otsikko <code>Content-Type: application\/json<\/code> olisi asetettava.<\/li>\n\n\n\n<li>Ainakin kentt\u00e4 <code>email<\/code> on pakollinen.<\/li>\n<\/ul>\n\n<h2 class=\"wp-block-heading\">Tunnistus<\/h2>\n\n<p>API:n k\u00e4ytt\u00e4miseen on k\u00e4ytett\u00e4viss\u00e4 kaksi vaihtoehtoa:<\/p>\n\n<p><strong>Basic Auth<\/strong><br\/>Sopii yksinkertaisiin integraatioihin tai sis\u00e4isiin j\u00e4rjestelmiin. Valtuutusotsakkeessa l\u00e4hetet\u00e4\u00e4n Base64-koodattu k\u00e4ytt\u00e4j\u00e4nimi ja salasana. <\/p>\n\n<p><strong>OAuth2<\/strong><br\/>Suositellaan tuottaviin integraatioihin ulkoisten j\u00e4rjestelmien kanssa. OAuth2 tarjoaa turvallisemman ja joustavammin hallittavissa olevan todennuksen. <\/p>\n\n<h2 class=\"wp-block-heading\">Siirr\u00e4 lis\u00e4kentti\u00e4<\/h2>\n\n<p><code>email<\/code> ja <code>firstname<\/code> lis\u00e4ksi voit lis\u00e4t\u00e4 my\u00f6s muita kentti\u00e4, kuten:<\/p>\n\n<ul class=\"wp-block-list\">\n<li>sukunimi<\/li>\n\n\n\n<li>yritys<\/li>\n\n\n\n<li>puhelin<\/li>\n\n\n\n<li>Omat r\u00e4\u00e4t\u00e4l\u00f6idyt yhteystietokent\u00e4t<\/li>\n<\/ul>\n\n<p>l\u00e4het\u00e4 mukaan. Kenttien nimien on vastattava t\u00e4sm\u00e4lleen k\u00e4ytt\u00e4j\u00e4n m\u00e4\u00e4rittelem\u00e4n kent\u00e4n aliasta. <\/p>\n\n<h2 class=\"wp-block-heading\">Viralliset asiakirjat<\/h2>\n\n<p>Kaikki k\u00e4ytett\u00e4viss\u00e4 olevat kent\u00e4t, vastauskoodit ja lis\u00e4esimerkkej\u00e4 on saatavilla API:n virallisessa dokumentaatiossa:<\/p>\n\n<p><a href=\"https:\/\/devdocs.mautic.org\/en\/5.x\/rest_api\/contacts.html#create-contact\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/devdocs.mautic.org\/en\/5.x\/rest_api\/contacts.html#create-contact<\/a><\/p>\n\n<p>Siell\u00e4 kuvataan my\u00f6s esimerkkej\u00e4 SDK:ista ja monimutkaisemmista k\u00e4ytt\u00f6tapauksista.<\/p>\n\n<h2 class=\"wp-block-heading\">Yhteenveto<\/h2>\n\n<p>Yhteyshenkil\u00f6 luodaan POST-pyynn\u00f6ll\u00e4 osoitteeseen <code>\/api\/contacts\/new<\/code>. Tunnistautuminen tapahtuu Basic Auth- tai OAuth2-tunnistautumisen avulla, ja v\u00e4hint\u00e4\u00e4n yksi s\u00e4hk\u00f6postiosoite on annettava. T\u00e4ydellinen kenttien yleiskatsaus l\u00f6ytyy API:n virallisesta dokumentaatiosta.  <\/p>\n","protected":false},"excerpt":{"rendered":"<p>Lyhyesti sanottuna: Voit luoda yhteydenoton Aivieen helposti REST API:n kautta l\u00e4hett\u00e4m\u00e4ll\u00e4 POST-pyynn\u00f6n p\u00e4\u00e4tepisteeseen \/api\/contacts\/new ja tunnistautumalla Basic Auth- tai OAuth2-tunnistautumisen avulla.<\/p>\n","protected":false},"featured_media":0,"template":"","categories":[],"tags":[1576,1577],"FaqCategories":[1429],"FaqTags":[1575,1424],"class_list":["post-28804","faq","type-faq","status-publish","hentry","tag-api","tag-ota-yhteyttae","FaqCategories-integraatiot","FaqTags-api","FaqTags-ota-yhteyttae"],"acf":[],"featured_image_urls_v2":{"full":"","thumbnail":"","medium":"","medium_large":"","large":"","post-thumbnail":"","aiv_480w":"","woocommerce_thumbnail":"","woocommerce_single":"","woocommerce_gallery_thumbnail":""},"post_excerpt_stackable_v2":"<p>Lyhyesti sanottuna: Voit luoda yhteydenoton Aivieen helposti REST API:n kautta l\u00e4hett\u00e4m\u00e4ll\u00e4 POST-pyynn\u00f6n p\u00e4\u00e4tepisteeseen \/api\/contacts\/new ja tunnistautumalla Basic Auth- tai OAuth2-tunnistautumisen avulla. Luo yhteyshenkil\u00f6 API:n kautta Voit luoda uuden yhteystiedon API-p\u00e4\u00e4tepisteen avulla: POST \/api\/contacts\/new Yksinkertainen esimerkki curl n\u00e4ytt\u00e4\u00e4 seuraavalta: curl \u2013location &#8217;https:\/\/aivie-v6.0.ddev.site\/api\/contacts\/new&#8217; \\ \u2013header &#8217;Authorization: Basic VVNF***==&#8217; \\ \u2013header &#8217;Content-Type: application\/json&#8217; \\ \u2013data-raw &#8217;{ &#8221;email\u201d: &#8221;aivie@dev.ch\u201d, &#8221;firstname\u201d: &#8221;aivie\u201d }&#8217; T\u00e4rke\u00e4\u00e4: Pyynt\u00f6 on l\u00e4hetett\u00e4v\u00e4 osoitteessa POST. Tunnistautuminen tapahtuu joko Basic Auth- tai OAuth2-tunnistautumisen avulla . Otsikko Content-Type: application\/json olisi asetettava. Ainakin kentt\u00e4 email on pakollinen. Tunnistus API:n k\u00e4ytt\u00e4miseen on k\u00e4ytett\u00e4viss\u00e4 kaksi vaihtoehtoa: Basic AuthSopii yksinkertaisiin integraatioihin tai sis\u00e4isiin j\u00e4rjestelmiin. Valtuutusotsakkeessa l\u00e4hetet\u00e4\u00e4n Base64-koodattu\u2026<\/p>\n","category_list_v2":"Yleinen","author_info_v2":{"name":"","url":""},"comments_num_v2":"0 comments","_links":{"self":[{"href":"https:\/\/aivie.ch\/fi\/wp-json\/wp\/v2\/faq\/28804","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/aivie.ch\/fi\/wp-json\/wp\/v2\/faq"}],"about":[{"href":"https:\/\/aivie.ch\/fi\/wp-json\/wp\/v2\/types\/faq"}],"version-history":[{"count":3,"href":"https:\/\/aivie.ch\/fi\/wp-json\/wp\/v2\/faq\/28804\/revisions"}],"predecessor-version":[{"id":28822,"href":"https:\/\/aivie.ch\/fi\/wp-json\/wp\/v2\/faq\/28804\/revisions\/28822"}],"wp:attachment":[{"href":"https:\/\/aivie.ch\/fi\/wp-json\/wp\/v2\/media?parent=28804"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/aivie.ch\/fi\/wp-json\/wp\/v2\/categories?post=28804"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/aivie.ch\/fi\/wp-json\/wp\/v2\/tags?post=28804"},{"taxonomy":"FaqCategories","embeddable":true,"href":"https:\/\/aivie.ch\/fi\/wp-json\/wp\/v2\/FaqCategories?post=28804"},{"taxonomy":"FaqTags","embeddable":true,"href":"https:\/\/aivie.ch\/fi\/wp-json\/wp\/v2\/FaqTags?post=28804"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}