A Consent Database API HTTP permite que você grave e recupere as ações de consentimento realizadas por seus usuários, que serão referidos na solução como “titulares”.
Atualização: adicionamos agora um canal Beta. Aqui você pode testar todos as funcionalidades mais recentes antes de serem movidas para o canal Current.
Para escrever na API, fornecemos dois tipos de chaves:
Todos os comandos realizadas para a API, tanto via HTTP quanto JS, indicam se o comando foi autenticada por uma chave privada ou pública. Isso permite que você dê mais confiança aos comandos que vieram da chave privada, que vêm com um maior nível de confiabilidade quando se trata de verificar se os dados foram realmente enviados por você.
Para a API HTTP, a chave privada deve ser enviada através do header ApiKey
. As chaves de API públicas são aceitas apenas no POST /public/consent
.
Atualização: Para proteger todas as comunicações entre a API REST e os clientes, o suporte ao protocolo HTTP está sendo descartado em todas as chamadas da API Consent Database. Após 31 de janeiro de 2023, todas as solicitações de APIs de Consent Database devem aderir ao protocolo HTTPS.
Para enviar dados para nosso API HTTP, o header Content-Type deve ser definido para application/json
ou application/x-www-form-urlencoded
.
❗️ As API HTTP da Consent Database são compatíveis apenas com JSON codificado em UTF-8. As APls retornarão o status HTTP 400 para quaisquer outros cabeçalhos de codificação enviados com uma solicitação.
O parâmetro unescape_json
, que foi usado para liberar o json da resposta passando unescape_json=true
para qualquer solicitação agora é ignorado e cada solicitação o considera como padrão.
Por padrão, você pode executar no máximo 50 solicitações por segundo e 108.000 solicitações por hora. Do lado do servidor, a API responderá com “429 Too Many Requests” se esses limites forem excedidos
Há um máximo de 1 MB por comando. Do lado do servidor, a API responderá com “413 Request Entity Too Large” se esses limites forem excedidos.
Exemplos →
GET https://consent.iubenda.com/consent
Para versão Beta:
GET https://consent.iubenda.com/beta/consent
Todos os campos são opcionais, mas alguns são preenchidos automaticamente se não forem fornecidos.
Parâmetros de consulta aceitos:
from_time | Opcional | String | Filtrar por carimbo de data/hora de consentimento. Retorna todos os consentimentos daquele momento em diante (inclusive). Formatos válidos: 2018-02-22 00:40:00 UTC, 2018-02-22T00:40:00Z (ISO 8601), 1519260000 (carimbo data/hora [timestamp] unix, em segundos). Padrão “null” | |
to_time | Opcional | String | Filtrar por timestamp de consentimento. Retorna todos os consentimentos daquele momento para trás (inclusive). Formatos válidos: 2018-02-22 00:40:00 UTC, 2018-02-22T00:40:00Z (ISO 8601), 1519260000 (timestamp de unix em segundos). Padrão “null” | |
source | Opcional | String | Filtrar por fonte de consentimento. Valores possíveis: público, privado. Padrão “null” | |
ip_address | Opcional | String | Filtrar por endereço de IP. Padrão nulo. Formatos Válidos (endereço de IP). Padrão “none” | |
subject_id | Opcional | String | Filtrar por ID do remetente. Padrão “null” | |
subject_email_exact | Opcional | String | Filtrar por Remetente de e-mail. Precisa estar exatamente igual (diferencia maiúsculas de minúsculas). Padrão “null” | |
subject_email | Opcional | String | Filtrar por Remetente de e-mail. Corresponde parcialmente à string (não diferencia maiúsculas de minúsculas). Padrão “null” | Descontinuado |
subject_first_name | Opcional | String | Filtrar pelo primeiro nome do Remetente. Precisa estar exatamente igual (diferencia maiúsculas de minúsculas). Padrão “null” | |
subject_last_name | Opcional | String | Filtrar pelo sobrenome do Remetente. precisa estar exatamente igual (diferencia maiúsculas de minúsculas). Padrão “null” | |
subject_full_name | Opcional | String | Filtrar pelo nome completo do Remetente. Ele corresponde à string parcialmente (não diferencia maiúsculas de minúsculas). Padrão “null” | Descontinuado |
subject_verified | Opcional | Boolean | Filtrar por status “Remetente verificado”. Valores possíveis: true, false. Padrão “null” | |
preference_key | Opcional | String | Filtre os consentimentos nos quais possuem a key. Padrão “null” | Descontinuado |
starting_after | Opcional | String | Cursor que indica após o qual Consentimento os resultados devem ser retornados (cursor excluído). Padrão “null” | |
limit | Opcional | Numeric | Número que indica o número de resultados retornados. Min: 1, Max: 100. Padrão “10” |
Este método suporta paginação baseada em cursor por meio do parâmetro starting_after
. Este parâmetro obtém um consentimento existente e retorna objetos depois dele.
Lembre-se de que os resultados são ordenados por padrão com carimbo de data/hora decrescente.
Alguns campos estão obsoletos e podem não ter bom desempenho. Nós desencorajamos o seu uso, pois podemos deixar de oferecer suporte no futuro.
Resposta:
# 200 OK
[{
"id": "b04c4b2b-80b7-439f-8997-ade3d35cbb95",
"timestamp": "2018-06-04T08:11:34.000+00:00",
"owner": "521686",
"source": "private",
"subject": {
"id": "0e371678-634a-4016-83ce-9b7c36f828e6",
"email": "83ce_634a_4016_9b7c36f828e6_0e371678@example.com",
"first_name": "Kianna",
"last_name": "Fahey",
"full_name": "Kianna Fahey",
"verified": false
},
"preferences": {
"newsletter": false
}
},
{
"id": "ee6644ea-08e9-4aaa-a7a9-18602731a123",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "681109",
"source": "public",
"subject": {
"id": "8c6d1b71-0908-4604-948f-2f706500b5b1",
"email": "0908.8c6d1b71.2f706500b5b1.4604.948f@example.org",
"first_name": "Eleanora",
"last_name": "Adams",
"full_name": "Eleanora Adams",
"verified": false
},
"preferences": {
"newsletter": true
}
},
{
"id": "e7a9f5db-481e-4c80-ac7d-a35e35d37f98",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "178473",
"source": "private",
"subject": {
"id": "d084ab70-0460-4523-94b2-44841055b49c",
"email": "94b2_4523_44841055b49c_0460_d084ab70@example.com",
"first_name": "Abbie",
"last_name": "Heidenreich",
"full_name": "Abbie Heidenreich",
"verified": false
},
"preferences": {
"third_party": true
}
},
{
"id": "e3481085-296c-4b11-a999-73d5d1309128",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "393753",
"source": "private",
"subject": {
"id": "be8ca546-150d-4a6e-b2ac-ef76fb8a279e",
"email": "b2ac_ef76fb8a279e_150d_4a6e_be8ca546@example.net",
"first_name": "Grace",
"last_name": "Dooley",
"full_name": "Grace Dooley",
"verified": false
},
"preferences": {
"another_preference_key": false,
"newsletter": false
}
},
{
"id": "e1be0320-a854-4b01-a468-49b1752ee4f3",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "629879",
"source": "public",
"subject": {
"id": "f8878254-c7ae-4169-b474-19e90d7b2f4f",
"email": "f8878254_b474_19e90d7b2f4f_4169_c7ae@example.net",
"first_name": "Providenci",
"last_name": "Kulas",
"full_name": "Providenci Kulas",
"verified": false
},
"preferences": {
"newsletter": false,
"random_preference_key": true,
"third_party": true,
"another_preference_key": false
}
},
{
"id": "cbe2bba8-d31d-4a27-9e2d-b38de4f22a68",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "989797",
"source": "public",
"subject": {
"id": "6387dc5d-d474-4da8-8c40-8b197dee8d7c",
"email": "6387dc5d.4da8.d474.8c40.8b197dee8d7c@example.com",
"first_name": "Alan",
"last_name": "Rutherford",
"full_name": "Alan Rutherford",
"verified": false
},
"preferences": {
"newsletter": true,
"random_preference_key": true
}
},
{
"id": "ca429c28-e1cd-4b95-87ae-48adb8fe56bb",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "885846",
"source": "public",
"subject": {
"id": "b2ad578d-0aa9-4bd5-becd-e2e7a2019e7a",
"email": "b2ad578d.becd.e2e7a2019e7a.0aa9.4bd5@example.net",
"first_name": "Ruby",
"last_name": "Lemke",
"full_name": "Ruby Lemke",
"verified": false
},
"preferences": {
"third_party": true,
"random_preference_key": false
}
},
{
"id": "bf12770e-840a-40cd-ab79-5d88576b6b73",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "369168",
"source": "public",
"subject": {
"id": "d4f24d92-56c2-4372-8696-fec829da5ccc",
"email": "fec829da5ccc.8696.4372.56c2.d4f24d92@example.com",
"first_name": "Hank",
"last_name": "Klein",
"full_name": "Hank Klein",
"verified": false
},
"preferences": {
"newsletter": false
}
},
{
"id": "b489e2d4-2fc6-44e1-ba54-e5f81000d30a",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "781022",
"source": "public",
"subject": {
"id": "38bc623f-b386-4b66-8ee6-5e7d91c19800",
"email": "38bc623f.8ee6.4b66.5e7d91c19800.b386@example.net",
"first_name": "Kamren",
"last_name": "Pacocha",
"full_name": "Kamren Pacocha",
"verified": false
},
"preferences": {
"newsletter": true
}
},
{
"id": "b2ec7aa8-35e7-470c-8b51-bd39fa686a3a",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "527898",
"source": "public",
"subject": {
"id": "0cc94c66-d9eb-4ace-af3d-1d48fba265f9",
"email": "1d48fba265f9_4ace_af3d_d9eb_0cc94c66@example.net",
"first_name": "Maryjane",
"last_name": "Wiegand",
"full_name": "Maryjane Wiegand",
"verified": false
},
"preferences": {
"newsletter": true
}
}
]
Observe que este método não inclui as provas e avisos legais do consentimento. Você precisa usar o comando GET /consent/:id
para obter o evento de Consentimento completo.
Exemplos →
GET https://consent.iubenda.com/consent/:id
Para versões Beta:
GET https://consent.iubenda.com/beta/consent/:id
# 200 OK
{
"id": "de801ca9-abec-45e2-8f7c-729822cfffad",
"timestamp": "2018-05-04T14:52:26Z",
"checksum": "336dd0c5ee2253794b8cca6ee2b2fec835ab25a7097c4405014d02e4ffe4d5e5",
"owner": "1",
"subject": {
"id": "custom_subject_id",
"owner_id": "1",
"email": "subject@example.com",
"first_name": "John",
"last_name": "Doe",
"verified": false
},
"preferences": {
"privacy_policy": true,
"newsletter": false
},
"legal_notices": [
{
"identifier": "privacy_policy",
"version": 123
},
{
"identifier": "term",
"version": 123
}
],
"proofs": [
{
"content": "proof_1",
"form": "proof_1 form"
},
{
"content": "proof_2",
"form": "proof_2 form"
}
],
"ip_address": null
}
Além das propriedades descritas anteriormente:
id | Identificador único do evento de consentimento específico | ||
owner | Identificador único do proprietário da key de uma API | ||
source | Privado | Público | Se o consentimento foi obtido através da key de uma API pública ou privada |
Exemplos →
POST https://consent.iubenda.com/consent
Para versões Beta:
POST https://consent.iubenda.com/beta/consent
{
"subject": {
"id": "testsubject",
"email": "subject@example.com",
"first_name": "John",
"last_name": "Doe",
"verified": false
},
"legal_notices": [
{
"identifier": "privacy_policy",
"version": 123
},
{
"identifier": "term",
"version": 123
}
],
"proofs": [
{
"content": "proof_1",
"form": "proof_1 form"
},
{
"content": "proof_2",
"form": "proof_2 form"
}
],
"preferences": {
"newsletter": false,
"privacy_policy": true
},
"ip_address": "127.0.0.1"
}
Este comando publicará um novo consentimento.
A resposta será algo como:
# 200 OK
{
"id": "de801ca9-abec-45e2-8f7c-729822cfffad",
"timestamp": "2018-05-04T14:52:26Z",
"subject_id": "testsubject"
}
O método de consentimento aceita os seguintes campos. Todos os campos são opcionais, mas alguns são preenchidos automaticamente se não forem fornecidos.
timestamp | Preenchidos automaticamente se não forem fornecidos | String | Carimbo data/hora no padrão ISO 8601, em que o consentimento ocorreu |
subject | Objeto | ||
id | Preenchidos automaticamente se não forem fornecidos | String | |
String | |||
first_name | String | ||
last_name | String | ||
full_name | String | ||
verified | Boolean | Campo reservado usado para sinalizar se um assunto é verificado, por exemplo, por meio do método double opt-in | |
legal_notices | Matriz | Matriz de objetos contendo dados legal_notices | |
identifier | String | privacy_policy, cookie_policy, termo ou um identificador personalizado | |
version | Preenchidos automaticamente se não forem fornecidos | String | |
proofs | Matriz | Matriz de objetos contendo dados de prova | |
content | Texto | ||
form | Texto | ||
preferences | Objeto | Conjuntos de key-value com preferências do usuário para a ação de consentimento | |
ip_address | Preenchidos automaticamente se usar “autodetect_ip_address” | String | Considere somente quando estiver usando uma key “privada”. Salva o endereço IP adquirido no Consentimento. Padrão “null” |
autodetect_ip_address | Padrão “true” | String | Considere somente quando estiver usando uma key “pública”. Habilita ou desabilita (true, false) a detecção automática do endereço IP. Padrão “true” |
Exemplos →
Para Beta:
GET https://consent.iubenda.com/beta/subjects/:id/consent/last
O método Last Consent retorna o último consentimento criado para o assunto fornecido.
A resposta é a seguinte:
# 200 OK
{
"id": "de801ca9-abec-45e2-8f7c-729822cfffad",
"timestamp": "2018-05-04T14:52:26Z",
"checksum": "336dd0c5ee2253794b8cca6ee2b2fec835ab25a7097c4405014d02e4ffe4d5e5",
"owner": "1",
"subject": {
"id": "custom_subject_id",
"owner_id": "1",
"email": "subject@example.com",
"first_name": "John",
"last_name": "Doe",
"verified": false
},
"preferences": {
"privacy_policy": true,
"newsletter": false
},
"legal_notices": [
{
"identifier": "privacy_policy",
"version": 123
},
{
"identifier": "term",
"version": 123
}
],
"proofs": [
{
"content": "proof_1",
"form": "proof_1 form"
},
{
"content": "proof_2",
"form": "proof_2 form"
}
],
"ip_address": null
}
Exemplos →
GET https://consent.iubenda.com/subjects
Para versões Beta:
GET https://consent.iubenda.com/beta/subjects
Todos os campos são opcionais, mas alguns são preenchidos automaticamente se não forem fornecidos.
Parâmetros de consulta aceitos:
id | Opcional | String | Filtra pelo id. Precisa estar exatamente igual. Padrão “null” | |
email_exact | Opcional | String | Filtra pelo e-mail. Precisa estar exatamente igual (diferencia maiúsculas de minúsculas). Padrão “null” | |
Opcional | String | Filtre por e-mail. Ele corresponde à string parcialmente (não diferencia maiúsculas de minúsculas) | Descontinuado | |
first_name | Opcional | String | Filtra pelo primeiro nome. Precisa estar exatamente igual (diferencia maiúsculas de minúsculas). Padrão “null” | |
last_name | Opcional | String | Filtra pelo sobrenome. Precisa estar exatamente igual (diferencia maiúsculas de minúsculas). Padrão “null” | |
full_name | Opcional | String | Filtre por nome completo. Ele corresponde à string parcialmente (não diferencia maiúsculas de minúsculas) | Descontinuado |
from_time | Opcional | String | Filtrar por carimbo de data/hora dos remetentes. Retorna todos os remetentes daquele momento em diante (inclusive). Formatos válidos: 2018-02-22 00:40:00 UTC, 2018-02-22T00:40:00Z (ISO 8601), 1519260000 (carimbo data/hora [timestamp] unix em segundos). Padrão “null” | |
to_time | Opcional | String | Filtrar por carimbo de data/hora dos remetentes. Retorna todos os remetentes daquela época para trás (inclusive). Formatos válidos: 2018-02-22 00:40:00 UTC, 2018-02-22T00:40:00Z (ISO 8601), 1519260000 (carimbo data/hora [timestamp] unix em segundos). Padrão “null” | |
verified | Opcional | Boolean | Filtrar por status verificado. Valores possíveis: true, false. Padrão “null” | |
starting_after | Opcional | String | Cursor que indica após qual Assunto os resultados devem ser retornados (cursor excluído). Padrão “null” | |
limit | Opcional | Numérico | Número que indica o número de resultados retornados. Min: 1, Max: 101. Padrão “10” |
Número que indica o número de resultados retornados no parâmetro starting_after
. Este parâmetro pega um assunto existente e retorna objetos depois dele.
Resposta:
# 200 OK
[
{
"id": "d2a55da5-0777-4625-94bd-b69948703e71",
"owner_id": "131132",
"email": "rath.jorge@example.com",
"first_name": "Jorge",
"last_name": "Rath",
"full_name": "Jorge Rath",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
},
{
"id": "b75c6d0c-550f-4f84-9e92-2f351d481220",
"owner_id": "131132",
"email": "aufderhar_alfonso@example.net",
"first_name": "Alfonso",
"last_name": "Aufderhar",
"full_name": "Alfonso Aufderhar",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
},
{
"id": "a9c8c720-cb07-4a52-81c3-7cb7fb4f877e",
"owner_id": "131132",
"email": "vandervort.furman@example.net",
"first_name": "Furman",
"last_name": "Vandervort",
"full_name": "Furman Vandervort",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
},
{
"id": "6ccc2802-3bcb-49af-a4c5-14dc89ba94bc",
"owner_id": "131132",
"email": "alvis.rohan@example.org",
"first_name": "Alvis",
"last_name": "Rohan",
"full_name": "Alvis Rohan",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
},
{
"id": "5900f856-619e-42b0-92a5-b2ebd016ac01",
"owner_id": "131132",
"email": "brown.marlee@example.net",
"first_name": "Marlee",
"last_name": "Brown",
"full_name": "Marlee Brown",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}
]
Alguns campos estão obsoletos e podem não ter bom desempenho. Nós desencorajamos seu uso, pois podemos abandonar o suporte no futuro.
Exemplos →
GET https://consent.iubenda.com/subjects/:id
Para versões Beta:
GET https://consent.iubenda.com/beta/subjects/:id
# 200 OK
{
"id": "testsubject",
"owner_id": "1",
"email": "subject@example.com",
"first_name": "John",
"last_name": "Doe",
"verified": false,
"preferences": {
"privacy_policy": {
"value": true,
"consent_id": "de801ca9-abec-45e2-8f7c-729822cfffad"
},
"newsletter": {
"value": true,
"consent_id": "de801ca9-abec-45e2-8f7c-729822cfffad"
}
}
}
Exemplos →
POST https://consent.iubenda.com/subjects
Para versões Beta:
POST https://consent.iubenda.com/beta/subjects
{
"id": "testsubject",
"email": "subject@example.com",
"first_name": "John",
"last_name": "Doe",
"full_name": "John Doe",
"verified": false
}
Este método postará um novo remetente. Também pode ser usado de dentro do consent
. Verifique a referência dentro do método consent
para mais detalhes.
id | preenchido automaticamente se não for fornecido | String | |
Opcional | String | ||
first_name | Opcional | String | |
last_name | Opcional | String | |
full_name | Opcional | String | |
verified | Opcional | Boolean | Campo reservado usado para sinalizar se um remetente é verificado, por exemplo, por meio do método double opt-in |
Em breve | |||
custom_attributes | Opcional | Objeto | Um conjunto de key-values contendo atributos personalizados |
A resposta será algo como:
# 200 OK
{
"id": "testsubject",
"created_at": "2018-05-04T14:52:26Z"
}
Exemplos →
PUT|PATCH https://consent.iubenda.com/subjects/:id
Para versões Beta:
PUT|PATCH https://consent.iubenda.com/beta/subjects/:id
{
"first_name": "Mary",
"verified": true
}
Este comando irá atualizar um titular existente..
A resposta será algo como:
# 200 OK
{
"id": "testsubject",
"created_at": "2018-05-04T14:52:26Z"
}
Exemplos →
GET https://consent.iubenda.com/legal_notices
Para versões Beta:
GET https://consent.iubenda.com/beta/legal_notices
Os documentos são retornados ordenados por timestamp (carimbo de data/hora).
Todos os campos são opcionais, mas alguns são preenchidos automaticamente se não forem fornecidos.
Parâmetros de consulta aceitos:
id | Opcional | String | Filtra pelo id. Precisa estar exatamente igual. Padrão “null” |
identifier | Opcional | String | Filtra pelo identificador. Precisa estar exatamente igual (diferencia maiúsculas de minúsculas). Padrão “null” |
version | Opcional | Numérico | Filtra pela versão. Precisa estar exatamente igual. Padrão “null” |
language | Opcional | String | Filtra por avisos legais cujos conteúdos incluem o idioma especificado (usando uma forma abreviada como “pt-br”, “en” etc.). Padrão “null” |
from_time | Opcional | String | Filtra por carimbo de data/hora de avisos legais. Retorna todos os avisos legais daquele momento em diante (inclusive). Formatos válidos: 2018-02-22 00:40:00 UTC, 2018-02-22T00:40:00Z (ISO 8601), 1519260000 (carimbo data/hora “timestamp” unix em segundos). Padrão “null” |
to_time | Opcional | String | Filtra por carimbo de data/hora de avisos legais. Retorna todos os avisos legais daquela época (inclusive). Formatos válidos: 2018-02-22 00:40:00 UTC, 2018-02-22T00:40:00Z (ISO 8601), 1519260000 (carimbo data/hora “timestamp” unix em segundos). Padrão “null” |
starting_after_version | Opcional | Numérico | Cursor que indica após qual versão do Aviso Legal os resultados devem ser retornados (cursor excluído). Padrão “null” |
starting_after_identifier | Opcional | String | Cursor que indica após qual identificador do Aviso Legal os resultados devem ser retornados (cursor excluído). Padrão “null” |
limit | Opcional | Numerico | Número que indica o número de resultados retornados. Min: 1, Max: 101. Padrão “10” |
Este método suporta paginação baseada em cursor por meio do parâmetro starting_after_version
e starting_after_identifier
. Esses parâmetros pegam um Aviso Legal existente e retornam objetos depois dele. Ambos os parâmetros são necessários para paginar.
Resposta:
# 200 OK
[
{
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 20,
"timestamp": "2018-10-09T12:38:04Z",
"content": {
"en": "Et vinculum clam decerno arguo admoveo velum sponte tot suppellex venustas defendo dolor decumbo est.",
"it": "Collum tutis esse confugo porro urbs varius abscido turpis decor praesentium tardus voluptate fugit numquam."
}
},
{
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 19,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Venia valde vel surculus capitulus adfectus patior comparo acsi cur vero super cursim.",
"it": "Consuasor arcesso conscendo crudelis cauda aer aut adeptio illo argentum comis subiungo subito colo."
}
},
{
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 18,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Ullus voco aufero speculum fugiat audacia laboriosam vilicus amita trans aut ut.",
"it": "Alo veritatis ipsa tristis cuius occaecati adflicto creta verecundia facere solvo despirmatio cupiditate crinis aqua bos."
}
},
{
"id": "0_privacy_policy",
"owner_id": "0",
"identifier": "privacy_policy",
"version": 17,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Confero succedo caelum adhaero quo vir deorsum quaerat utor sit ustulo cribro.",
"it": "Bibo cubitum unus est ambitus contego apparatus alo via abutor utroque xiphias voco."
}
},
{
"id": "0_privacy_policy",
"owner_id": "0",
"identifier": "privacy_policy",
"version": 16,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Qui porro culpo attero benevolentia aut sed sulum adfero artificiose adsidue tam amo validus vel spectaculum.",
"it": "Cerno ipsum fugit compello cursim ter surgo asporto debilito excepturi adversus facere."
}
},
{
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 15,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Tunc timidus veritatis maiores advenio aperio testimonium defluo celo cuius adsuesco deripio.",
"it": "Depulso dignissimos vinitor curatio caelestis cedo et sum concedo id admoneo appositus."
}
},
{
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 14,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Repellat mollitia desidero videlicet est textilis stips nisi aequus solum depromo agnitio usus.",
"it": "Vomito tonsor comitatus illum aut usitas laboriosam canonicus tepesco benigne confugo trado."
}
},
{
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 13,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Temperantia alias somniculosus absorbeo utique caecus terror demitto trucido desidero baiulus sublime.",
"it": "Perspiciatis at tredecim curriculum comprehendo deduco corrupti attonbitus barba cruentus communis comparo thorax cauda spero vito anser."
}
},
{
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 12,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Allatus cena surculus ventito ver adversus torrens demo venustas toties veritas qui cado vis.",
"it": "Talio avoco aptus compono et subiungo peior bellum depromo aureus torqueo adeptio nobis."
}
},
{
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 11,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Aliquam cubicularis tergum utor cinis concido ratione vociferor uter deduco tertius verecundia alo claustrum sto vos aegrotatio.",
"it": "Corona ut comes sub coaegresco caute casus laboriosam tremo vulariter aegrotatio pauci callide assentator basium."
}
}
]
Exemplos →
GET https://consent.iubenda.com/legal_notices/:identifier/:version
Para versões Beta:
GET https://consent.iubenda.com/beta/legal_notices/:identifier/:version
Resposta:
# GET /legal_notices/privacy_policy/3
# 200 OK
{
"identifier": "privacy_policy",
"version": 3,
"timestamp": "2018-05-16T13:55:57Z",
"content": "privacy policy content"
}
Exemplos →
GET https://consent.iubenda.com/legal_notices/:identifier
Para versões Beta:
GET https://consent.iubenda.com/beta/legal_notices/:identifier
Os documentos são retornados ordenados por versão.
Parâmetros de consulta aceitos:
limit | Opcional | Número | Limite o número de resultados. Padrão “10” |
starting_after | Opcional | Número | Cursor para uso na paginação. Padrão “null” |
Este método suporta paginação baseada em cursor por meio do parâmetro starting_after
. Este parâmetro usa uma versão existente do Aviso Legal e retorna os objetos na ordem inversa.
# 200 OK
[
{
"identifier": "privacy_policy",
"version": 3,
"timestamp": "2018-05-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
},
{
"identifier": "privacy_policy",
"version": 2,
"timestamp": "2018-03-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
},
{
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-01-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}
]
Observe que, este método não inclui o conteúdo do Aviso Legal, apenas os metadados de cada um. Você deveria usar o comando GET /legal_notices/:identifier/:version
para obter o documento completo.
Se você usar iubenda para seus documentos legais, atualizaremos automaticamente o conteúdo do método legal_notices
para você sempre que seus documentos legais são alterados. Você pode ler sobre como habilitar este recurso aqui.
Exemplos →
POST https://consent.iubenda.com/legal_notices
Para versões Beta:
POST https://consent.iubenda.com/beta/legal_notices
{
"identifier": "privacy_policy",
"content": "privacy policy content",
"timestamp": "2018-05-16T13:55:57Z"
}
Com conteúdo multilíngue:
{
"identifier": "privacy_policy",
"content": {
"en": "privacy policy content",
"it": "contenuto della privacy policy"
},
"timestamp": "2018-05-16T13:55:57Z"
}
Resposta:
# 200 OK
{
"identifier": "privacy_policy",
"timestamp": "2018-05-16T13:55:57Z",
"version": 1
}
POST https://consent.iubenda.com/legal_notices
Para versões Beta:
POST https://consent.iubenda.com/beta/legal_notices
[
{
"identifier": "privacy_policy",
"content": "privacy policy content",
"timestamp": "2018-05-16T13:55:57Z"
},
{
"identifier": "cookie_policy",
"content": "cookie policy content",
"timestamp": "2018-05-16T13:55:57Z"
}
]
Resposta:
# 200 OK
[
{
"identifier": "privacy_policy",
"timestamp": "2018-05-16T13:55:57Z",
"version": 1
},
{
"identifier": "cookie_policy",
"timestamp": "2018-05-16T13:55:57Z",
"version": 1
}
]
POST /consent
$ curl https://consent.iubenda.com/consent \
-X POST \
-H "ApiKey: your-private-api-key" \
-H "Content-Type: application/json" \
-d '{ "subject": { "id": "J02eZvKYlo2ClwuJ1", "email": "subject@example.com" }, "preferences": { "newsletter": true }, "legal_notices": [{ "identifier": "privacy_policy" }], "proofs": [{ "content": "proof_content", "form": "proof_form" }], "ip_address": "127.0.0.1" }'
Resposta:
{
"id": "1dbbc6f8-6a57-4407-b687-d6e6f818742f",
"timestamp": "2018-06-06T09:48:44.265Z",
"subject_id": "J02eZvKYlo2ClwuJ1"
}
GET /consent
$ curl https://consent.iubenda.com/consent/ \
-H "ApiKey: your-private-api-key"
Resposta:
[{
"id": "b04c4b2b-80b7-439f-8997-ade3d35cbb95",
"timestamp": "2018-06-04T08:11:34.000+00:00",
"owner": "12345",
"source": "private",
"subject": {
"id": "0e371678-634a-4016-83ce-9b7c36f828e6",
"email": "83ce_634a_4016_9b7c36f828e6_0e371678@example.com",
"first_name": "Kianna",
"last_name": "Fahey",
"full_name": "Kianna Fahey",
"verified": false
},
"preferences": {
"newsletter": false
},
"ip_address": "79.42.49.139"
}, {
"id": "ee6644ea-08e9-4aaa-a7a9-18602731a123",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "12345",
"source": "public",
"subject": {
"id": "8c6d1b71-0908-4604-948f-2f706500b5b1",
"email": "0908.8c6d1b71.2f706500b5b1.4604.948f@example.org",
"first_name": "Eleanora",
"last_name": "Adams",
"full_name": "Eleanora Adams",
"verified": false
},
"preferences": {
"newsletter": true
},
"ip_address": null
}, {
"id": "bf12770e-840a-40cd-ab79-5d88576b6b73",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "12345",
"source": "public",
"subject": {
"id": "d4f24d92-56c2-4372-8696-fec829da5ccc",
"email": "fec829da5ccc.8696.4372.56c2.d4f24d92@example.com",
"first_name": "Hank",
"last_name": "Klein",
"full_name": "Hank Klein",
"verified": false
},
"preferences": {
"newsletter": false
},
"ip_address": "79.42.49.139"
}]
GET /consent/:id
$ curl https://consent.iubenda.com/consent/1dbbc6f8-6a57-4407-b687-d6e6f818742f \
-H "ApiKey: your-private-api-key"
Resposta:
{
"id": "1dbbc6f8-6a57-4407-b687-d6e6f818742f",
"timestamp": "2018-05-04T14:52:26Z",
"owner": "1",
"subject": {
"id": "custom_subject_id",
"owner_id": "1",
"email": "subject@example.com",
"first_name": "John",
"last_name": "Doe",
"verified": false
},
"preferences": {
"privacy_policy": true,
"newsletter": false
},
"legal_notices": [{
"identifier": "privacy_policy",
"version": "123.0"
}, {
"identifier": "term",
"version": "123.0"
}],
"proofs": [{
"content": "proof_1",
"form": "proof_1 form"
}, {
"content": "proof_2",
"form": "proof_2 form"
}],
"ip_address": null
}
POST /beta/consent
$ curl https://consent.iubenda.com/beta/consent \
-X POST \
-H "ApiKey: your-private-api-key" \
-H "Content-Type: application/json" \
-d '{ "subject": { "id": "J02eZvKYlo2ClwuJ1", "email": "subject@example.com" }, "preferences": { "newsletter": true }, "legal_notices": [{ "identifier": "privacy_policy" }], "proofs": [{ "content": "proof_content", "form": "proof_form" }], "ip_address": "127.0.0.1" }'
Resposta:
{
"id": "1dbbc6f8-6a57-4407-b687-d6e6f818742f",
"timestamp": "2018-06-06T09:48:44.265Z",
"subject_id": "J02eZvKYlo2ClwuJ1"
}
GET /beta/consent
$ curl https://consent.iubenda.com/beta/consent/ \
-H "ApiKey: your-private-api-key"
Resposta:
[{
"id": "b04c4b2b-80b7-439f-8997-ade3d35cbb95",
"timestamp": "2018-06-04T08:11:34.000+00:00",
"owner": "12345",
"source": "private",
"subject": {
"id": "0e371678-634a-4016-83ce-9b7c36f828e6",
"email": "83ce_634a_4016_9b7c36f828e6_0e371678@example.com",
"first_name": "Kianna",
"last_name": "Fahey",
"full_name": "Kianna Fahey",
"verified": false
},
"preferences": {
"newsletter": false
},
"ip_address": "79.42.49.139"
}, {
"id": "ee6644ea-08e9-4aaa-a7a9-18602731a123",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "12345",
"source": "public",
"subject": {
"id": "8c6d1b71-0908-4604-948f-2f706500b5b1",
"email": "0908.8c6d1b71.2f706500b5b1.4604.948f@example.org",
"first_name": "Eleanora",
"last_name": "Adams",
"full_name": "Eleanora Adams",
"verified": false
},
"preferences": {
"newsletter": true
},
"ip_address": null
}, {
"id": "bf12770e-840a-40cd-ab79-5d88576b6b73",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "12345",
"source": "public",
"subject": {
"id": "d4f24d92-56c2-4372-8696-fec829da5ccc",
"email": "fec829da5ccc.8696.4372.56c2.d4f24d92@example.com",
"first_name": "Hank",
"last_name": "Klein",
"full_name": "Hank Klein",
"verified": false
},
"preferences": {
"newsletter": false
},
"ip_address": "79.42.49.139"
}]
GET /beta/consent/:id
$ curl https://consent.iubenda.com/beta/consent/1dbbc6f8-6a57-4407-b687-d6e6f818742f \
-H "ApiKey: your-private-api-key"
Resposta:
{
"id": "1dbbc6f8-6a57-4407-b687-d6e6f818742f",
"timestamp": "2018-05-04T14:52:26Z",
"owner": "1",
"subject": {
"id": "custom_subject_id",
"owner_id": "1",
"email": "subject@example.com",
"first_name": "John",
"last_name": "Doe",
"verified": false
},
"preferences": {
"privacy_policy": true,
"newsletter": false
},
"legal_notices": [{
"identifier": "privacy_policy",
"version": 123
}, {
"identifier": "term",
"version": 123
}],
"proofs": [{
"content": "proof_1",
"form": "proof_1 form"
}, {
"content": "proof_2",
"form": "proof_2 form"
}],
"ip_address": null
}
POST /consent
$consent_data = array(
"subject" => array(
"id" => "J02eZvKYlo2ClwuJ1",
"email" => "subject@example.com"
),
"legal_notices" => array(
array(
"identifier" => "newsletter"
),
array(
"identifier" => "privacy_policy"
)
),
"proofs" => array(
array(
"content" => "proof_content",
"form" => "proof_form"
)
),
"preferences" => array(
"newsletter" => true,
"privacy_policy" => true
),
"ip_address" => "127.0.0.1"
);
$req = curl_init();
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/consent');
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
curl_setopt($req, CURLOPT_POST, true);
curl_setopt($req, CURLOPT_POSTFIELDS, json_encode($consent_data));
$response = curl_exec($req);
Resposta:
{
"id": "7abe5f70-22e4-4181-878c-9f931034fab5",
"timestamp": "2018-06-08T08:25:30.395Z",
"subject_id": "J02eZvKYlo2ClwuJ1"
}
GET /consent
$req = curl_init();
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/consent');
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
$response = curl_exec($req);
Resposta:
[{
"id": "b04c4b2b-80b7-439f-8997-ade3d35cbb95",
"timestamp": "2018-06-04T08:11:34.000+00:00",
"owner": "12345",
"source": "private",
"subject": {
"id": "0e371678-634a-4016-83ce-9b7c36f828e6",
"email": "83ce_634a_4016_9b7c36f828e6_0e371678@example.com",
"first_name": "Kianna",
"last_name": "Fahey",
"full_name": "Kianna Fahey",
"verified": false
},
"preferences": {
"newsletter": false
},
"ip_address": "79.42.49.139"
}, {
"id": "ee6644ea-08e9-4aaa-a7a9-18602731a123",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "12345",
"source": "public",
"subject": {
"id": "8c6d1b71-0908-4604-948f-2f706500b5b1",
"email": "0908.8c6d1b71.2f706500b5b1.4604.948f@example.org",
"first_name": "Eleanora",
"last_name": "Adams",
"full_name": "Eleanora Adams",
"verified": false
},
"preferences": {
"newsletter": true
},
"ip_address": null
}, {
"id": "bf12770e-840a-40cd-ab79-5d88576b6b73",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "12345",
"source": "public",
"subject": {
"id": "d4f24d92-56c2-4372-8696-fec829da5ccc",
"email": "fec829da5ccc.8696.4372.56c2.d4f24d92@example.com",
"first_name": "Hank",
"last_name": "Klein",
"full_name": "Hank Klein",
"verified": false
},
"preferences": {
"newsletter": false
},
"ip_address": "79.42.49.139"
}]
GET /consent/:id
$req = curl_init();
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/consent/7abe5f70-22e4-4181-878c-9f931034fab5');
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
$response = curl_exec($req);
Resposta:
{
"id": "1dbbc6f8-6a57-4407-b687-d6e6f818742f",
"timestamp": "2018-05-04T14:52:26Z",
"owner": "1",
"subject": {
"id": "custom_subject_id",
"owner_id": "1",
"email": "subject@example.com",
"first_name": "John",
"last_name": "Doe",
"verified": false
},
"preferences": {
"privacy_policy": true,
"newsletter": false
},
"legal_notices": [{
"identifier": "privacy_policy",
"version": "123.0"
}, {
"identifier": "term",
"version": "123.0"
}],
"proofs": [{
"content": "proof_1",
"form": "proof_1 form"
}, {
"content": "proof_2",
"form": "proof_2 form"
}],
"ip_address": null
}
POST /beta/consent
$consent_data = array(
"subject" => array(
"id" => "J02eZvKYlo2ClwuJ1",
"email" => "subject@example.com"
),
"legal_notices" => array(
array(
"identifier" => "newsletter"
),
array(
"identifier" => "privacy_policy"
)
),
"proofs" => array(
array(
"content" => "proof_content",
"form" => "proof_form"
)
),
"preferences" => array(
"newsletter" => true,
"privacy_policy" => true
),
"ip_address" => "127.0.0.1"
);
$req = curl_init();
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/beta/consent');
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
curl_setopt($req, CURLOPT_POST, true);
curl_setopt($req, CURLOPT_POSTFIELDS, json_encode($consent_data));
$response = curl_exec($req);
Resposta:
{
"id": "7abe5f70-22e4-4181-878c-9f931034fab5",
"timestamp": "2018-06-08T08:25:30.395Z",
"subject_id": "J02eZvKYlo2ClwuJ1"
}
GET /beta/consent
$req = curl_init();
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/beta/consent');
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
$response = curl_exec($req);
Resposta:
[{
"id": "b04c4b2b-80b7-439f-8997-ade3d35cbb95",
"timestamp": "2018-06-04T08:11:34.000+00:00",
"owner": "12345",
"source": "private",
"subject": {
"id": "0e371678-634a-4016-83ce-9b7c36f828e6",
"email": "83ce_634a_4016_9b7c36f828e6_0e371678@example.com",
"first_name": "Kianna",
"last_name": "Fahey",
"full_name": "Kianna Fahey",
"verified": false
},
"preferences": {
"newsletter": false
},
"ip_address": "79.42.49.139"
}, {
"id": "ee6644ea-08e9-4aaa-a7a9-18602731a123",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "12345",
"source": "public",
"subject": {
"id": "8c6d1b71-0908-4604-948f-2f706500b5b1",
"email": "0908.8c6d1b71.2f706500b5b1.4604.948f@example.org",
"first_name": "Eleanora",
"last_name": "Adams",
"full_name": "Eleanora Adams",
"verified": false
},
"preferences": {
"newsletter": true
},
"ip_address": null
}, {
"id": "bf12770e-840a-40cd-ab79-5d88576b6b73",
"timestamp": "2018-06-04T08:11:33.000+00:00",
"owner": "12345",
"source": "public",
"subject": {
"id": "d4f24d92-56c2-4372-8696-fec829da5ccc",
"email": "fec829da5ccc.8696.4372.56c2.d4f24d92@example.com",
"first_name": "Hank",
"last_name": "Klein",
"full_name": "Hank Klein",
"verified": false
},
"preferences": {
"newsletter": false
},
"ip_address": "79.42.49.139"
}]
GET /beta/consent/:id
$req = curl_init();
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/beta/consent/7abe5f70-22e4-4181-878c-9f931034fab5');
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
$response = curl_exec($req);
Resposta:
{
"id": "1dbbc6f8-6a57-4407-b687-d6e6f818742f",
"timestamp": "2018-05-04T14:52:26Z",
"owner": "1",
"subject": {
"id": "custom_subject_id",
"owner_id": "1",
"email": "subject@example.com",
"first_name": "John",
"last_name": "Doe",
"verified": false
},
"preferences": {
"privacy_policy": true,
"newsletter": false
},
"legal_notices": [{
"identifier": "privacy_policy",
"version": 123
}, {
"identifier": "term",
"version": 123
}],
"proofs": [{
"content": "proof_1",
"form": "proof_1 form"
}, {
"content": "proof_2",
"form": "proof_2 form"
}],
"ip_address": null
}
POST /subjects
$ curl https://consent.iubenda.com/subjects \
-X POST \
-H "ApiKey: your-private-api-key" \
-H "Content-Type: application/json" \
-d '{ "email": "john@example.com", "first_name": "John", "last_name": "Doe" }'
Resposta:
{
"id": "9f5a50f6-052c-4595-8bc4-760dc05d86ba",
"timestamp": "2018-06-06T11:05:41.600Z"
}
GET /subjects
$ curl https://consent.iubenda.com/subjects \
-X GET \
-H "ApiKey: your-private-api-key" \
-H "Content-Type: application/json"
Resposta:
[{
"id": "d2a55da5-0777-4625-94bd-b69948703e71",
"owner_id": "131132",
"email": "rath.jorge@example.com",
"first_name": "Jorge",
"last_name": "Rath",
"full_name": "Jorge Rath",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "b75c6d0c-550f-4f84-9e92-2f351d481220",
"owner_id": "131132",
"email": "aufderhar_alfonso@example.net",
"first_name": "Alfonso",
"last_name": "Aufderhar",
"full_name": "Alfonso Aufderhar",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "a9c8c720-cb07-4a52-81c3-7cb7fb4f877e",
"owner_id": "131132",
"email": "vandervort.furman@example.net",
"first_name": "Furman",
"last_name": "Vandervort",
"full_name": "Furman Vandervort",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "6ccc2802-3bcb-49af-a4c5-14dc89ba94bc",
"owner_id": "131132",
"email": "alvis.rohan@example.org",
"first_name": "Alvis",
"last_name": "Rohan",
"full_name": "Alvis Rohan",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "5900f856-619e-42b0-92a5-b2ebd016ac01",
"owner_id": "131132",
"email": "brown.marlee@example.net",
"first_name": "Marlee",
"last_name": "Brown",
"full_name": "Marlee Brown",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}]
GET /subjects/:id
$ curl https://consent.iubenda.com/subjects/9f5a50f6-052c-4595-8bc4-760dc05d86ba \
-H "ApiKey: your-private-api-key"
Resposta:
{
"id": "9f5a50f6-052c-4595-8bc4-760dc05d86ba",
"owner_id": "123",
"email": "john@example.com",
"first_name": "John",
"last_name": "Doe",
"full_name": null,
"preferences": null,
"verified": false,
"timestamp": "2018-06-06T11:05:41+00:00"
}
PATCH /subjects/:id
$ curl https://consent.iubenda.com/subjects/9f5a50f6-052c-4595-8bc4-760dc05d86ba \
-X PATCH \
-H "ApiKey: your-private-api-key" \
-H "Content-Type: application/json" \
-d '{ "email": "mary@example.com", "first_name": "Mary", "last_name": "Doe" }'
Resposta:
{
"id": "9f5a50f6-052c-4595-8bc4-760dc05d86ba",
"timestamp": "2018-06-06T11:05:41.000+00:00"
}
GET /beta/subjects
$ curl https://consent.iubenda.com/beta/subjects \
-X GET \
-H "ApiKey: your-private-api-key" \
-H "Content-Type: application/json"
Resposta:
[{
"id": "d2a55da5-0777-4625-94bd-b69948703e71",
"owner_id": "131132",
"email": "rath.jorge@example.com",
"first_name": "Jorge",
"last_name": "Rath",
"full_name": "Jorge Rath",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "b75c6d0c-550f-4f84-9e92-2f351d481220",
"owner_id": "131132",
"email": "aufderhar_alfonso@example.net",
"first_name": "Alfonso",
"last_name": "Aufderhar",
"full_name": "Alfonso Aufderhar",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "a9c8c720-cb07-4a52-81c3-7cb7fb4f877e",
"owner_id": "131132",
"email": "vandervort.furman@example.net",
"first_name": "Furman",
"last_name": "Vandervort",
"full_name": "Furman Vandervort",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "6ccc2802-3bcb-49af-a4c5-14dc89ba94bc",
"owner_id": "131132",
"email": "alvis.rohan@example.org",
"first_name": "Alvis",
"last_name": "Rohan",
"full_name": "Alvis Rohan",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "5900f856-619e-42b0-92a5-b2ebd016ac01",
"owner_id": "131132",
"email": "brown.marlee@example.net",
"first_name": "Marlee",
"last_name": "Brown",
"full_name": "Marlee Brown",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}]
GET /beta/subjects/:id
$ curl https://consent.iubenda.com/beta/subjects/9f5a50f6-052c-4595-8bc4-760dc05d86ba \
-H "ApiKey: your-private-api-key"
Resposta:
{
"id": "9f5a50f6-052c-4595-8bc4-760dc05d86ba",
"owner_id": "123",
"email": "john@example.com",
"first_name": "John",
"last_name": "Doe",
"full_name": null,
"preferences": null,
"verified": false,
"timestamp": "2018-06-06T11:05:41+00:00"
}
PATCH /beta/subjects/:id
$ curl https://consent.iubenda.com/beta/subjects/9f5a50f6-052c-4595-8bc4-760dc05d86ba \
-X PATCH \
-H "ApiKey: your-private-api-key" \
-H "Content-Type: application/json" \
-d '{ "email": "mary@example.com", "first_name": "Mary", "last_name": "Doe" }'
Resposta:
{
"id": "9f5a50f6-052c-4595-8bc4-760dc05d86ba",
"timestamp": "2018-06-06T11:05:41.000+00:00"
}
POST /subjects
$subject_data = array(
"email" => "subject@example.com",
"first_name" => "John",
"last_name" => "Doe"
);
$req = curl_init();
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/subjects');
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
curl_setopt($req, CURLOPT_POST, true);
curl_setopt($req, CURLOPT_POSTFIELDS, json_encode($subject_data));
$response = curl_exec($req);
Resposta:
{
"id": "df39c1bf-5f27-4c3a-bf94-64360cc7e4f8",
"timestamp": "2018-06-11T08:57:13.662Z"
}
GET /subjects
$subject_data = array(
"email" => "subject@example.com",
"first_name" => "John",
"last_name" => "Doe"
);
$req = curl_init();
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/subjects');
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
curl_setopt($req, CURLOPT_POST, true);
curl_setopt($req, CURLOPT_POSTFIELDS, json_encode($subject_data));
$response = curl_exec($req);
Resposta:
[{
"id": "d2a55da5-0777-4625-94bd-b69948703e71",
"owner_id": "131132",
"email": "rath.jorge@example.com",
"first_name": "Jorge",
"last_name": "Rath",
"full_name": "Jorge Rath",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "b75c6d0c-550f-4f84-9e92-2f351d481220",
"owner_id": "131132",
"email": "aufderhar_alfonso@example.net",
"first_name": "Alfonso",
"last_name": "Aufderhar",
"full_name": "Alfonso Aufderhar",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "a9c8c720-cb07-4a52-81c3-7cb7fb4f877e",
"owner_id": "131132",
"email": "vandervort.furman@example.net",
"first_name": "Furman",
"last_name": "Vandervort",
"full_name": "Furman Vandervort",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "6ccc2802-3bcb-49af-a4c5-14dc89ba94bc",
"owner_id": "131132",
"email": "alvis.rohan@example.org",
"first_name": "Alvis",
"last_name": "Rohan",
"full_name": "Alvis Rohan",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "5900f856-619e-42b0-92a5-b2ebd016ac01",
"owner_id": "131132",
"email": "brown.marlee@example.net",
"first_name": "Marlee",
"last_name": "Brown",
"full_name": "Marlee Brown",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}]
GET /subjects/:id
$req = curl_init();
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/subjects/df39c1bf-5f27-4c3a-bf94-64360cc7e4f8');
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
$response = curl_exec($req);
Resposta:
{
"id": "9f5a50f6-052c-4595-8bc4-760dc05d86ba",
"owner_id": "123",
"email": "john@example.com",
"first_name": "John",
"last_name": "Doe",
"full_name": null,
"preferences": null,
"verified": false,
"timestamp": "2018-06-06T11:05:41+00:00"
}
PATCH /subjects/:id
$subject_data = array(
"first_name" => "Mary"
);
$req = curl_init();
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/subjects/df39c1bf-5f27-4c3a-bf94-64360cc7e4f8');
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'PATCH');
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
curl_setopt($req, CURLOPT_POSTFIELDS, json_encode($subject_data));
$response = curl_exec($req);
Resposta:
{
"id": "df39c1bf-5f27-4c3a-bf94-64360cc7e4f8",
"timestamp": "2018-06-11T08:57:13.000+00:00"
}
POST /beta/subjects
$subject_data = array(
"email" => "subject@example.com",
"first_name" => "John",
"last_name" => "Doe"
);
$req = curl_init();
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/beta/subjects');
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
curl_setopt($req, CURLOPT_POST, true);
curl_setopt($req, CURLOPT_POSTFIELDS, json_encode($subject_data));
$response = curl_exec($req);
Resposta:
{
"id": "df39c1bf-5f27-4c3a-bf94-64360cc7e4f8",
"timestamp": "2018-06-11T08:57:13.662Z"
}
GET /beta/subjects
$subject_data = array(
"email" => "subject@example.com",
"first_name" => "John",
"last_name" => "Doe"
);
$req = curl_init();
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/beta/subjects');
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
curl_setopt($req, CURLOPT_POST, true);
curl_setopt($req, CURLOPT_POSTFIELDS, json_encode($subject_data));
$response = curl_exec($req);
Resposta:
[{
"id": "d2a55da5-0777-4625-94bd-b69948703e71",
"owner_id": "131132",
"email": "rath.jorge@example.com",
"first_name": "Jorge",
"last_name": "Rath",
"full_name": "Jorge Rath",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "b75c6d0c-550f-4f84-9e92-2f351d481220",
"owner_id": "131132",
"email": "aufderhar_alfonso@example.net",
"first_name": "Alfonso",
"last_name": "Aufderhar",
"full_name": "Alfonso Aufderhar",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "a9c8c720-cb07-4a52-81c3-7cb7fb4f877e",
"owner_id": "131132",
"email": "vandervort.furman@example.net",
"first_name": "Furman",
"last_name": "Vandervort",
"full_name": "Furman Vandervort",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "6ccc2802-3bcb-49af-a4c5-14dc89ba94bc",
"owner_id": "131132",
"email": "alvis.rohan@example.org",
"first_name": "Alvis",
"last_name": "Rohan",
"full_name": "Alvis Rohan",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}, {
"id": "5900f856-619e-42b0-92a5-b2ebd016ac01",
"owner_id": "131132",
"email": "brown.marlee@example.net",
"first_name": "Marlee",
"last_name": "Brown",
"full_name": "Marlee Brown",
"preferences": null,
"verified": true,
"timestamp": "2018-09-12T16:22:21+00:00"
}]
GET /beta/subjects/:id
$req = curl_init();
$req = curl_init();
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/beta/subjects/df39c1bf-5f27-4c3a-bf94-64360cc7e4f8');
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
$response = curl_exec($req);
Resposta:
{
"id": "9f5a50f6-052c-4595-8bc4-760dc05d86ba",
"owner_id": "123",
"email": "john@example.com",
"first_name": "John",
"last_name": "Doe",
"full_name": null,
"preferences": null,
"verified": false,
"timestamp": "2018-06-06T11:05:41+00:00"
}
PATCH /beta/subjects/:id
$subject_data = array(
"first_name" => "Mary"
);
$req = curl_init();
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/beta/subjects/df39c1bf-5f27-4c3a-bf94-64360cc7e4f8');
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'PATCH');
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
curl_setopt($req, CURLOPT_POSTFIELDS, json_encode($subject_data));
$response = curl_exec($req);
Resposta:
{
"id": "df39c1bf-5f27-4c3a-bf94-64360cc7e4f8",
"timestamp": "2018-06-11T08:57:13.000+00:00"
}
POST /legal_notices
$ curl https://consent.iubenda.com/legal_notices \
-X POST \
-H "ApiKey: your-private-api-key" \
-H "Content-Type: application/json" \
-d '{ "identifier": "privacy_policy", "content": "privacy policy legal text" }'
Resposta:
{
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-06-06T15:56:10.090Z"
}
GET /legal_notices
$ curl https://consent.iubenda.com/legal_notices \
-H "ApiKey: your-private-api-key"
Resposta:
[{
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 20,
"timestamp": "2018-10-09T12:38:04Z",
"content": {
"en": "Et vinculum clam decerno arguo admoveo velum sponte tot suppellex venustas defendo dolor decumbo est.",
"it": "Collum tutis esse confugo porro urbs varius abscido turpis decor praesentium tardus voluptate fugit numquam."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 19,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Venia valde vel surculus capitulus adfectus patior comparo acsi cur vero super cursim.",
"it": "Consuasor arcesso conscendo crudelis cauda aer aut adeptio illo argentum comis subiungo subito colo."
}
}, {
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 18,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Ullus voco aufero speculum fugiat audacia laboriosam vilicus amita trans aut ut.",
"it": "Alo veritatis ipsa tristis cuius occaecati adflicto creta verecundia facere solvo despirmatio cupiditate crinis aqua bos."
}
}, {
"id": "0_privacy_policy",
"owner_id": "0",
"identifier": "privacy_policy",
"version": 17,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Confero succedo caelum adhaero quo vir deorsum quaerat utor sit ustulo cribro.",
"it": "Bibo cubitum unus est ambitus contego apparatus alo via abutor utroque xiphias voco."
}
}, {
"id": "0_privacy_policy",
"owner_id": "0",
"identifier": "privacy_policy",
"version": 16,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Qui porro culpo attero benevolentia aut sed sulum adfero artificiose adsidue tam amo validus vel spectaculum.",
"it": "Cerno ipsum fugit compello cursim ter surgo asporto debilito excepturi adversus facere."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 15,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Tunc timidus veritatis maiores advenio aperio testimonium defluo celo cuius adsuesco deripio.",
"it": "Depulso dignissimos vinitor curatio caelestis cedo et sum concedo id admoneo appositus."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 14,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Repellat mollitia desidero videlicet est textilis stips nisi aequus solum depromo agnitio usus.",
"it": "Vomito tonsor comitatus illum aut usitas laboriosam canonicus tepesco benigne confugo trado."
}
}, {
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 13,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Temperantia alias somniculosus absorbeo utique caecus terror demitto trucido desidero baiulus sublime.",
"it": "Perspiciatis at tredecim curriculum comprehendo deduco corrupti attonbitus barba cruentus communis comparo thorax cauda spero vito anser."
}
}, {
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 12,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Allatus cena surculus ventito ver adversus torrens demo venustas toties veritas qui cado vis.",
"it": "Talio avoco aptus compono et subiungo peior bellum depromo aureus torqueo adeptio nobis."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 11,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Aliquam cubicularis tergum utor cinis concido ratione vociferor uter deduco tertius verecundia alo claustrum sto vos aegrotatio.",
"it": "Corona ut comes sub coaegresco caute casus laboriosam tremo vulariter aegrotatio pauci callide assentator basium."
}
}]
GET /legal_notices/:identifier/:version
$ curl https://consent.iubenda.com/legal_notices/privacy_policy/1 \
-H "ApiKey: your-private-api-key"
Resposta:
{
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-06-06T15:56:10.000+00:00",
"content": "privacy policy legal text"
}
GET /legal_notices/:identifier
$ curl https://consent.iubenda.com/legal_notices/privacy_policy \
-H "ApiKey: your-private-api-key"
Resposta:
[{
"identifier": "privacy_policy",
"version": 3,
"timestamp": "2018-05-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}, {
"identifier": "privacy_policy",
"version": 2,
"timestamp": "2018-03-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}, {
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-01-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}]
Com parâmetros de limite e paginação:
$ curl https://consent.iubenda.com/legal_notices/privacy_policy?limit=20&starting_after=3 \
-H "ApiKey: your-private-api-key" \
-G
Resposta:
[{
"identifier": "privacy_policy",
"version": 2,
"timestamp": "2018-03-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}, {
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-01-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}]
POST /beta/legal_notices
$ curl https://consent.iubenda.com/beta/legal_notices \
-X POST \
-H "ApiKey: your-private-api-key" \
-H "Content-Type: application/json" \
-d '{ "identifier": "privacy_policy", "content": "privacy policy legal text" }'
Resposta:
{
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-06-06T15:56:10.090Z"
}
GET /beta/legal_notices
$ curl https://consent.iubenda.com/beta/legal_notices \
-H "ApiKey: your-private-api-key"
Resposta:
[{
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 20,
"timestamp": "2018-10-09T12:38:04Z",
"content": {
"en": "Et vinculum clam decerno arguo admoveo velum sponte tot suppellex venustas defendo dolor decumbo est.",
"it": "Collum tutis esse confugo porro urbs varius abscido turpis decor praesentium tardus voluptate fugit numquam."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 19,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Venia valde vel surculus capitulus adfectus patior comparo acsi cur vero super cursim.",
"it": "Consuasor arcesso conscendo crudelis cauda aer aut adeptio illo argentum comis subiungo subito colo."
}
}, {
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 18,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Ullus voco aufero speculum fugiat audacia laboriosam vilicus amita trans aut ut.",
"it": "Alo veritatis ipsa tristis cuius occaecati adflicto creta verecundia facere solvo despirmatio cupiditate crinis aqua bos."
}
}, {
"id": "0_privacy_policy",
"owner_id": "0",
"identifier": "privacy_policy",
"version": 17,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Confero succedo caelum adhaero quo vir deorsum quaerat utor sit ustulo cribro.",
"it": "Bibo cubitum unus est ambitus contego apparatus alo via abutor utroque xiphias voco."
}
}, {
"id": "0_privacy_policy",
"owner_id": "0",
"identifier": "privacy_policy",
"version": 16,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Qui porro culpo attero benevolentia aut sed sulum adfero artificiose adsidue tam amo validus vel spectaculum.",
"it": "Cerno ipsum fugit compello cursim ter surgo asporto debilito excepturi adversus facere."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 15,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Tunc timidus veritatis maiores advenio aperio testimonium defluo celo cuius adsuesco deripio.",
"it": "Depulso dignissimos vinitor curatio caelestis cedo et sum concedo id admoneo appositus."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 14,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Repellat mollitia desidero videlicet est textilis stips nisi aequus solum depromo agnitio usus.",
"it": "Vomito tonsor comitatus illum aut usitas laboriosam canonicus tepesco benigne confugo trado."
}
}, {
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 13,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Temperantia alias somniculosus absorbeo utique caecus terror demitto trucido desidero baiulus sublime.",
"it": "Perspiciatis at tredecim curriculum comprehendo deduco corrupti attonbitus barba cruentus communis comparo thorax cauda spero vito anser."
}
}, {
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 12,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Allatus cena surculus ventito ver adversus torrens demo venustas toties veritas qui cado vis.",
"it": "Talio avoco aptus compono et subiungo peior bellum depromo aureus torqueo adeptio nobis."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 11,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Aliquam cubicularis tergum utor cinis concido ratione vociferor uter deduco tertius verecundia alo claustrum sto vos aegrotatio.",
"it": "Corona ut comes sub coaegresco caute casus laboriosam tremo vulariter aegrotatio pauci callide assentator basium."
}
}]
GET /beta/legal_notices/:identifier/:version
$ curl https://consent.iubenda.com/beta/legal_notices/privacy_policy/1 \
-H "ApiKey: your-private-api-key"
Resposta:
{
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-06-06T15:56:10.000+00:00",
"content": "privacy policy legal text"
}
GET /beta/legal_notices/:identifier
$ curl https://consent.iubenda.com/beta/legal_notices/privacy_policy \
-H "ApiKey: your-private-api-key"
Resposta:
[{
"identifier": "privacy_policy",
"version": 3,
"timestamp": "2018-05-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}, {
"identifier": "privacy_policy",
"version": 2,
"timestamp": "2018-03-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}, {
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-01-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}]
Com parâmetros de limite e paginação:
$ curl https://consent.iubenda.com/beta/legal_notices/privacy_policy?limit=20&starting_after=3 \
-H "ApiKey: your-private-api-key" \
-G
Resposta:
[{
"identifier": "privacy_policy",
"version": 2,
"timestamp": "2018-03-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}, {
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-01-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}]
POST /legal_notices
$legal_notice_data = array(
"identifier" => "privacy_policy",
"content" => "privacy policy legal text"
);
$req = curl_init();
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/legal_notices');
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
curl_setopt($req, CURLOPT_POST, true);
curl_setopt($req, CURLOPT_POSTFIELDS, json_encode($legal_notice_data));
$response = curl_exec($req);
Resposta:
{
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-06-11T10:26:00.413Z"
}
GET /legal_notices
$legal_notice_data = array(
"identifier" => "privacy_policy",
"content" => "privacy policy legal text"
);
$req = curl_init();
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/legal_notices');
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
curl_setopt($req, CURLOPT_POST, true);
curl_setopt($req, CURLOPT_POSTFIELDS, json_encode($legal_notice_data));
$response = curl_exec($req);
Resposta:
[{
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 20,
"timestamp": "2018-10-09T12:38:04Z",
"content": {
"en": "Et vinculum clam decerno arguo admoveo velum sponte tot suppellex venustas defendo dolor decumbo est.",
"it": "Collum tutis esse confugo porro urbs varius abscido turpis decor praesentium tardus voluptate fugit numquam."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 19,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Venia valde vel surculus capitulus adfectus patior comparo acsi cur vero super cursim.",
"it": "Consuasor arcesso conscendo crudelis cauda aer aut adeptio illo argentum comis subiungo subito colo."
}
}, {
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 18,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Ullus voco aufero speculum fugiat audacia laboriosam vilicus amita trans aut ut.",
"it": "Alo veritatis ipsa tristis cuius occaecati adflicto creta verecundia facere solvo despirmatio cupiditate crinis aqua bos."
}
}, {
"id": "0_privacy_policy",
"owner_id": "0",
"identifier": "privacy_policy",
"version": 17,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Confero succedo caelum adhaero quo vir deorsum quaerat utor sit ustulo cribro.",
"it": "Bibo cubitum unus est ambitus contego apparatus alo via abutor utroque xiphias voco."
}
}, {
"id": "0_privacy_policy",
"owner_id": "0",
"identifier": "privacy_policy",
"version": 16,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Qui porro culpo attero benevolentia aut sed sulum adfero artificiose adsidue tam amo validus vel spectaculum.",
"it": "Cerno ipsum fugit compello cursim ter surgo asporto debilito excepturi adversus facere."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 15,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Tunc timidus veritatis maiores advenio aperio testimonium defluo celo cuius adsuesco deripio.",
"it": "Depulso dignissimos vinitor curatio caelestis cedo et sum concedo id admoneo appositus."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 14,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Repellat mollitia desidero videlicet est textilis stips nisi aequus solum depromo agnitio usus.",
"it": "Vomito tonsor comitatus illum aut usitas laboriosam canonicus tepesco benigne confugo trado."
}
}, {
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 13,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Temperantia alias somniculosus absorbeo utique caecus terror demitto trucido desidero baiulus sublime.",
"it": "Perspiciatis at tredecim curriculum comprehendo deduco corrupti attonbitus barba cruentus communis comparo thorax cauda spero vito anser."
}
}, {
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 12,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Allatus cena surculus ventito ver adversus torrens demo venustas toties veritas qui cado vis.",
"it": "Talio avoco aptus compono et subiungo peior bellum depromo aureus torqueo adeptio nobis."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 11,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Aliquam cubicularis tergum utor cinis concido ratione vociferor uter deduco tertius verecundia alo claustrum sto vos aegrotatio.",
"it": "Corona ut comes sub coaegresco caute casus laboriosam tremo vulariter aegrotatio pauci callide assentator basium."
}
}]
GET /legal_notices/:identifier/:version
$req = curl_init();
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/legal_notices/privacy_policy/1');
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
$response = curl_exec($req);
Resposta:
{
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-06-11T10:26:00.000+00:00",
"content": "privacy policy legal text"
}
GET /legal_notices/:identifier
$req = curl_init();
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/legal_notices/privacy_policy');
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
$response = curl_exec($req);
Resposta:
[{
"identifier": "privacy_policy",
"version": 3,
"timestamp": "2018-05-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}, {
"identifier": "privacy_policy",
"version": 2,
"timestamp": "2018-03-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}, {
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-01-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}]
Com parâmetros de limite e paginação:
$req = curl_init();
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/legal_notices/privacy_policy?limit=3&starting_after=4');
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
$response = curl_exec($req);
Resposta:
[{
"identifier": "privacy_policy",
"version": 2,
"timestamp": "2018-03-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}, {
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-01-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}]
POST /beta/legal_notices
$legal_notice_data = array(
"identifier" => "privacy_policy",
"content" => "privacy policy legal text"
);
$req = curl_init();
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/beta/legal_notices');
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
curl_setopt($req, CURLOPT_POST, true);
curl_setopt($req, CURLOPT_POSTFIELDS, json_encode($legal_notice_data));
$response = curl_exec($req);
Resposta:
{
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-06-11T10:26:00.413Z"
}
GET /beta/legal_notices
$legal_notice_data = array(
"identifier" => "privacy_policy",
"content" => "privacy policy legal text"
);
$req = curl_init();
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/beta/legal_notices');
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
curl_setopt($req, CURLOPT_POST, true);
curl_setopt($req, CURLOPT_POSTFIELDS, json_encode($legal_notice_data));
$response = curl_exec($req);
Resposta:
[{
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 20,
"timestamp": "2018-10-09T12:38:04Z",
"content": {
"en": "Et vinculum clam decerno arguo admoveo velum sponte tot suppellex venustas defendo dolor decumbo est.",
"it": "Collum tutis esse confugo porro urbs varius abscido turpis decor praesentium tardus voluptate fugit numquam."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 19,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Venia valde vel surculus capitulus adfectus patior comparo acsi cur vero super cursim.",
"it": "Consuasor arcesso conscendo crudelis cauda aer aut adeptio illo argentum comis subiungo subito colo."
}
}, {
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 18,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Ullus voco aufero speculum fugiat audacia laboriosam vilicus amita trans aut ut.",
"it": "Alo veritatis ipsa tristis cuius occaecati adflicto creta verecundia facere solvo despirmatio cupiditate crinis aqua bos."
}
}, {
"id": "0_privacy_policy",
"owner_id": "0",
"identifier": "privacy_policy",
"version": 17,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Confero succedo caelum adhaero quo vir deorsum quaerat utor sit ustulo cribro.",
"it": "Bibo cubitum unus est ambitus contego apparatus alo via abutor utroque xiphias voco."
}
}, {
"id": "0_privacy_policy",
"owner_id": "0",
"identifier": "privacy_policy",
"version": 16,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Qui porro culpo attero benevolentia aut sed sulum adfero artificiose adsidue tam amo validus vel spectaculum.",
"it": "Cerno ipsum fugit compello cursim ter surgo asporto debilito excepturi adversus facere."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 15,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Tunc timidus veritatis maiores advenio aperio testimonium defluo celo cuius adsuesco deripio.",
"it": "Depulso dignissimos vinitor curatio caelestis cedo et sum concedo id admoneo appositus."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 14,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Repellat mollitia desidero videlicet est textilis stips nisi aequus solum depromo agnitio usus.",
"it": "Vomito tonsor comitatus illum aut usitas laboriosam canonicus tepesco benigne confugo trado."
}
}, {
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 13,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Temperantia alias somniculosus absorbeo utique caecus terror demitto trucido desidero baiulus sublime.",
"it": "Perspiciatis at tredecim curriculum comprehendo deduco corrupti attonbitus barba cruentus communis comparo thorax cauda spero vito anser."
}
}, {
"id": "0_cookie_policy",
"owner_id": "0",
"identifier": "cookie_policy",
"version": 12,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Allatus cena surculus ventito ver adversus torrens demo venustas toties veritas qui cado vis.",
"it": "Talio avoco aptus compono et subiungo peior bellum depromo aureus torqueo adeptio nobis."
}
}, {
"id": "0_term",
"owner_id": "0",
"identifier": "term",
"version": 11,
"timestamp": "2018-10-09T12:38:03Z",
"content": {
"en": "Aliquam cubicularis tergum utor cinis concido ratione vociferor uter deduco tertius verecundia alo claustrum sto vos aegrotatio.",
"it": "Corona ut comes sub coaegresco caute casus laboriosam tremo vulariter aegrotatio pauci callide assentator basium."
}
}]
GET /beta/legal_notices/:identifier/:version
$req = curl_init();
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/beta/legal_notices/privacy_policy/1');
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
$response = curl_exec($req);
Resposta:
{
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-06-11T10:26:00.000+00:00",
"content": "privacy policy legal text"
}
GET /beta/legal_notices/:identifier
$req = curl_init();
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/beta/legal_notices/privacy_policy');
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
$response = curl_exec($req);
Resposta:
[{
"identifier": "privacy_policy",
"version": 3,
"timestamp": "2018-05-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}, {
"identifier": "privacy_policy",
"version": 2,
"timestamp": "2018-03-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}, {
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-01-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}]
Com parâmetros de limite e paginação:
$req = curl_init();
curl_setopt($req, CURLOPT_RETURNTRANSFER, true);
curl_setopt($req, CURLOPT_URL, 'https://consent.iubenda.com/beta/legal_notices/privacy_policy?limit=3&starting_after=4');
curl_setopt($req, CURLOPT_HTTPHEADER, array(
'ApiKey: your-secret-api-key',
'Content-Type: application/json'
));
$response = curl_exec($req);
Resposta:
[{
"identifier": "privacy_policy",
"version": 2,
"timestamp": "2018-03-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}, {
"identifier": "privacy_policy",
"version": 1,
"timestamp": "2018-01-16T13:55:57Z",
"id": "1234_privacy_policy",
"owner_id": "1234",
"content": "privacy policy content"
}]