Gerenciar Termos e Condições

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

Introdução

É preciso adicionar Termos e Condições ("Termos e Condições") ao perfil da organização antes de publicar um plano de tarifas. Os Termos e Condições ficam fora do perfil da organização. No perfil da organização, especifique o local (URL público) dos Termos e Condições.

Depois de publicar um plano de tarifas, a versão atual dos termos e condições vai aparecer no portal do desenvolvedor. Os desenvolvedores só podem comprar um plano depois de aceitar os Termos e Condições atuais.

Como adicionar Termos e Condições usando a interface

  1. Acesse a página do perfil da organização, conforme descrito em Conheça o perfil da organização.
  2. Clique em Editar.
  3. Na seção "Termos e condições" da página do perfil da organização, clique em Adicionar termos e condições.

    A caixa de diálogo "Novos termos e condições" é exibida

  4. Digite as seguintes informações:
    Campo Descrição
    Início da vigência

    Data em que os Termos e Condições entraram em vigor. O padrão é a data atual. Você deve inserir a data atual ou uma data futura.

    Versão

    Versão dos Termos e Condições. O número da versão permite que você acompanhe as diferentes versões dos Termos e Condições.

    URL

    URL dos Termos e Condições.

  5. Clique em Criar.

    Os novos Termos e Condições são adicionados à seção "Termos e Condições" da página do perfil da organização.

  6. Repita as etapas de 3 a 5 para adicionar outros Termos e Condições.
  7. Clique em Salvar para salvar as mudanças no perfil da organização.

Como editar Termos e Condições usando a interface

Não é possível editar os Termos e Condições diretamente. Exclua os Termos e Condições que você quer editar e adicione uma nova entrada.

Como excluir Termos e Condições usando a interface

  1. Acesse a página do perfil da organização, conforme descrito em Conheça o perfil da organização.
  2. Clique em Editar na página do perfil da organização.
  3. Na lista de termos e condições, posicione o cursor sobre aqueles que você quer excluir.
  4. Clique em .

Como gerenciar Termos e Condições usando a API

Gerencie os Termos e Condições usando a API, conforme descrito nas seções a seguir.

Como adicionar Termos e Condições usando uma API

Adicione termos e condições enviando uma solicitação POST para /mint/organizations/{org_name}/tncs. Ao adicionar os termos e condições, é possível especificar:

  • URL
  • Texto complementar (como uma descrição)
  • Data em que os Termos e Condições estão em vigor
  • Número da versão

Para mais informações sobre essas opções, consulte as Propriedades de configuração dos Termos e Condições.

Exemplo:

curl -X POST   "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs" \
  -H "Content-Type: application/json" \
  -d \
  '{
     "url":"www.testoperator/termsandconditions",
     "tncText":"Sample text for the T&C",
     "version":"1.1",
     "startDate":"2018-09-24"
  }' \
  -u email:password

Veja a seguir um exemplo de resposta:

{
   "id" : "6803d70a-18cc-40c8-b250-675c5e8a75c ",
   "organization" : {     
     …
   },
   "startDate" : "2018-09-24 00:00:00",
   "tncText" : "Sample text for the T&C",
   "url" : "www.testoperator/termsandconditions",
   "version" : "1.1"
 }

Como acessar os Termos e Condições usando a API

Consulte Termos e Condições específicos ou todos os Termos e Condições de uma organização.

Consulte Termos e Condições específicos enviando uma solicitação GET para /mint/organizations/{org_name}/tncs/{tncs_id}, em que {tncs_id} é a identificação dos Termos e Condições específicos (o ID é retornado na resposta quando você cria os T&Cs). Exemplo:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs/6803d70a-18cc-40c8-b250-675c5e8a75c" \
  -H "Accept: application/json"  \
  -u email:password

Confira todos os Termos e Condições da organização enviando uma solicitação GET para /mint/organizations/{org_name}/tncs. Exemplo:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs" \
  -H "Accept: application/json" \
  -u email:password

Veja a seguir um exemplo de resposta:

{

"tnc" : [
  {
    "id" : "77193339-8d79-44a8-8af2-3593f16c158e",
    "organization" :
    {
      ...
    },
   "startDate" : "2018-07-01 00:00:00",
   "tncText" : "Big operator text for the T&C",
   "url" : "www.bigoperator/termsandconditions",
   "version" : "1.0"
  },
  {
    "id" : "6803d70a-18cc-40c8-b250-675c5e8a75c3",
    "organization" : {
    ...
  },
    "startDate" : "2018-09-24 00:00:00",
    "tncText" : "Sample text for the T&C",
    "url" : "www.testoperator/termsandconditions",
    "version" : "1.1"
  }
  ]
   "totalRecords" : 2
}

Aceitando um documento de Termos e Condições para um desenvolvedor ou empresa que usa a API

Aceitar um documento de Termos e Condições de um desenvolvedor ou empresa específica emitindo uma solicitação POST para uma das seguintes APIs, respectivamente:

  • /mint/organizations/{org_name}/developers/{dev_id}/tncs/{tncs_id}/developer-tncs
  • /mint/organizations/{org_name}/companies/{company_id}/tncs/{tncs_id}/developer-tncs

Em que {dev_id} é o ID do desenvolvedor (endereço de e-mail), {company_id} é o ID da empresa e {tncs_id} é o ID do documento de Termos e Condições.

Exemplo:

curl -X POST "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/dev2@myorg.com/tncs/5a291b86-42e3-4ae1-8db3-efe4b0877316/developer-tncs" \
  -H "Content-Type: application/json" \
  -d \
  '{
     "action":"ACCEPTED",
     "auditDate":"2018-10-01 00:00:00"
  }' \
  -u email:password

Veja a seguir um exemplo de resposta:

Observação: no payload de resposta, o auditDate é definido como o horário atual em UTC.
{
  "action": "ACCEPTED",
  "auditDate": "2018-10-01 07:24:45",
  "id": "dev2@myorg.com",
  "tnc": {
      "id": "5a291b86-42e3-4ae1-8db3-efe4b0877316",
      ...
  }
}

Acessar os Termos e Condições aceitos por um desenvolvedor ou empresa usando a API

Consulte os Termos e Condições aceitos por um desenvolvedor ou empresa específica emitindo uma solicitação GET para uma das seguintes APIs, respectivamente:

  • /mint/organizations/{org_name}/developers/{dev_id}/developer-tncs
  • /mint/organizations/{org_name}/companies/{company_id}/developer-tncs

Em que {dev_id} é o ID do desenvolvedor (endereço de e-mail) e {company_id} é o ID da empresa.

Exemplo:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/dev2@myorg.com/developer-tncs" \
  -H "Accept:application/json"  \
  -u email:password

Veja a seguir um exemplo de resposta:

{
  "developerTnc": [
  {
    "action": "ACCEPTED",
    "auditDate": "2018-08-29 07:24:45",
    "id": "dev2@myorg.com",
    "tnc": {
      "id": "26abc14c-c628-4c38-8840-a343c8ee9437",
      ...
    }
  }],
  "totalRecords": 1
}

Como editar Termos e Condições usando a API

Edite os Termos e Condições enviando uma solicitação PUT para /mint/organizations/{org_named}/tncs/{tncs_id}, em que {tncs_id} é a identificação dos Termos e Condições. Ao fazer a atualização, é necessário especificar no corpo da solicitação as configurações atualizadas e a identificação dos Termos e Condições. Por exemplo, a solicitação a seguir edita o número da versão dos Termos e Condições (a propriedade atualizada está destacada no exemplo):

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs/cfbb03b3-b707-495b-9b8a-ff67d71065a9" \
  -H "Content-Type: application/json" \
  -d {
    "id":"6803d70a-18cc-40c8-b250-675c5e8a75c",
    "version":"1.2"
  }' \
  -u email:password

Veja a seguir um exemplo de resposta:

{
   "id" : "cfbb03b3-b707-495b-9b8a-ff67d71065a9",
   "organization" : {
       "address" : [ {
       "address1" : "Test address",
       "city" : "Test City",
       "country" : "US",
       "id" : "test-address",
       "isPrimary" : true,
       "state" : "CA",
       "zip" : "54321"
     } ],
     …"
   },
   "startDate" : "2018-09-24 00:00:00",
   "tncText" : "Sample text for the T&C",
   "url" : "www.testoperator/termsandconditions",
   "version" : "1.2"
 }

Como excluir Termos e Condições usando a API

Exclua termos e condições enviando uma solicitação DELETE para /mint/organizations/{org_name}/tncs/{tncs_id}, em que {tncs_id} é a identificação dos termos e condições. Exemplo:

curl -X DELETE "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/tncs/6803d70a-18cc-40c8-b250-675c5e8a75c" \
  -H "Accept: application/json"  \
  -u email:password

Propriedades de configuração dos Termos e Condições da API

A tabela a seguir resume as propriedades de configuração que podem ser definidas usando a API para termos e condições.

Nome Descrição Padrão Obrigatório?
url

URL dos Termos e Condições.

N/A Não
tncText

Texto (como uma breve descrição) para os Termos e Condições.

N/A Não
version

Versão dos Termos e Condições. O número da versão permite que você acompanhe versões diferentes dos Termos e Condições.

N/A Sim
startDate

Data em que os Termos e Condições entram em vigor.

N/A Sim
organization

Organização dos Termos e Condições.

N/A Não

Próximas etapas

Saiba como adicionar moedas suportadas àquelas configuradas inicialmente para sua organização em Gerenciar moedas aceitas.