{"id":1575,"date":"2020-09-19T21:21:25","date_gmt":"2020-09-20T00:21:25","guid":{"rendered":"https:\/\/kondado.com.br\/blog\/wiki\/?p=1575"},"modified":"2025-04-10T14:54:11","modified_gmt":"2025-04-10T17:54:11","slug":"comecando-com-a-api-da-kondado","status":"publish","type":"post","link":"https:\/\/kondado.com.br\/blog\/wiki\/2020\/09\/19\/comecando-com-a-api-da-kondado\/","title":{"rendered":"Come\u00e7ando com a API da Kondado"},"content":{"rendered":"\n<p>A API da Kondado permite que voc\u00ea acople programaticamente a nossa plataforma ao seu stack de analytics, melhorando o entrosamento entre todas as etapas do seu ecossistema.<\/p>\n\n\n\n<h4 id=\"baseurl\"><strong>URL Base<\/strong><\/h4>\n\n\n\n<p>A n\u00e3o ser que a documenta\u00e7\u00e3o de algum endpoint especifique de outra forma, todas as chamadas dever\u00e3o ser feitas com a seguinte URL base:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">https:\/\/k2.kondado.com.br<\/pre>\n\n\n\n<h4 id=\"authentication\"><strong>Autentica\u00e7\u00e3o<\/strong><\/h4>\n\n\n\n<p>Antes de come\u00e7ar com a nossa API, voc\u00ea precisar\u00e1 gerar tokens de acesso conforme <a href=\"https:\/\/kondado.com.br\/blog\/wiki\/tokens-de-acesso\/\" data-type=\"URL\" data-id=\"https:\/\/kondado.com.br\/blog\/wiki\/tokens-de-acesso\/\">este tutorial<\/a>. Os tokens criados herdar\u00e3o as permiss\u00f5es do usu\u00e1rio que os gerou e servir\u00e3o para autenticar as suas chamadas de forma segura e facilmente revog\u00e1vel sem que voc\u00ea precise alterar sua senha.<\/p>\n\n\n\n<p>O token ser\u00e1 composto de 2 components: chave (identifica\u00e7\u00e3o do token) e token (&#8220;senha&#8221; do token).<\/p>\n\n\n\n<p>Em posse de chave e token, voc\u00ea dever\u00e1 pass\u00e1-los como par\u00e2metros para a chamada da seguinte forma:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">key: chave do token\ntoken: token<\/pre>\n\n\n\n<p><strong>Exemplo de URL autenticada<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">https:\/\/k2.kondado.com.br\/{endpoint}?<strong>key<\/strong>=chavedotoken&amp;<strong>token<\/strong>=seutokenaqui<\/pre>\n\n\n\n<h4><strong>Limite de requisi\u00e7oes<\/strong><\/h4>\n\n\n\n<p>A API possui 2 limites, aplicados por IP e por <em>key<\/em>:<\/p>\n\n\n\n<ul><li>1 requisi\u00e7\u00e3o por segundo<\/li><li>20 requisi\u00e7\u00f5es por minuto<\/li><\/ul>\n\n\n\n<p>Ao atingir estes limites, ser\u00e1 retornado o erro abaixo (com c\u00f3digo de status 200):<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">{\n    \"success\":false,\n    \"error\":\"RATE_LIMIT_EXCEEDED\",\n    \"message\":\"Too many requests. Please try again in 60 seconds.\"\n}<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>Conceitos iniciais, URL Base e autentica\u00e7\u00e3o para voc\u00ea utilizar a API da Kondado<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[334],"tags":[4,333],"_links":{"self":[{"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/posts\/1575"}],"collection":[{"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/comments?post=1575"}],"version-history":[{"count":15,"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/posts\/1575\/revisions"}],"predecessor-version":[{"id":9766,"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/posts\/1575\/revisions\/9766"}],"wp:attachment":[{"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/media?parent=1575"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/categories?post=1575"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/tags?post=1575"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}