---
title: "Encomendar um projeto Public Cloud através da API OVHcloud"
description: "Saiba como encomendar o seu projeto Public Cloud com a API OVHcloud"
url: https://docs.ovhcloud.com/pt/guides/account-and-service-management/managing-billing-payments-and-services/order-project-api
lang: pt
lastUpdated: 2020-12-09
---
# Encomendar um projeto Public Cloud através da API OVHcloud

## Objetivo

A criação de um projeto é a primeira etapa da implantação de [instâncias Public Cloud](https://www.ovhcloud.com/pt/public-cloud/).

**Este guia explica como encomendar um projeto Public Cloud através da APIv6 OVHcloud.**

## Requisitos

- Dispor de identificadores OVHcloud válidos
- Dispor de um [método de pagamento](/pt/guides/account-and-service-management/managing-billing-payments-and-services/manage-payment-methods.md) válido e registado na sua conta OVHcloud
- Estar familiarizado com o [funcionamento da APIv6 OVHcloud](/pt/guides/manage-and-operate/api/first-steps.md)

## Instruções

Ligue-se à [interface API OVHcloud](https://eu.api.ovh.com/) e siga os passos abaixo.

### 1 - construir o carrinho

A primeira etapa de uma encomenda consiste em criar um "carrinho" (cart). De seguida, poderá adicionar um projeto Public Cloud.

#### Criar o carrinho

Utilize esta chamada para criar o carrinho:


🇪🇺EU▾

[POST/order/cart](https://eu.api.ovh.com/console/?section=/order&branch=v1#post-/order/cart)

Queira escolher à sua filial da API OVHcloud. Na resposta, tome nota do número do carrinho ("cartId"); será necessário identificar este carrinho.

De seguida, deverá adicionar um projeto Public Cloud como um artigo. Utilize esta chamada com o seu "cartId" para verificar a disponibilidade do serviço:


🇪🇺EU▾

[GET/order/cart/{cartId}/cloud](https://eu.api.ovh.com/console/?section=/order&branch=v1#get-/order/cart/-cartId-/cloud)

Na resposta, pode verificar os parâmetros relativos a um projeto Public Cloud:

> **código\_plan**: "Projeto.2018"
>
> **productName**: "Projeto Public Cloud"

#### Adicionar um projeto ao carrinho

Utilize esta chamada para adicionar o artigo ao seu carrinho:


🇪🇺EU▾

[POST/order/cart/{cartId}/cloud](https://eu.api.ovh.com/console/?section=/order&branch=v1#post-/order/cart/-cartId-/cloud)

Devem ser fornecidas as seguintes informações, extraídas nas etapas anteriores:

| Campo      | Valor                |
| ---------- | -------------------- |
| CartId     | _ID do seu carrinho_ |
| duração    | P1M                  |
| planCode   | Projeto.2018         |
| priceMode  | default              |
| quantidade | 1                    |

A resposta incluirá um itemId que pode ser utilizado (juntamente com o "cartId") para identificar o artigo do cabaz:


🇪🇺EU▾

[GET/order/cart/{cartId}/item/{itemId}](https://eu.api.ovh.com/console/?section=/order&branch=v1#get-/order/cart/-cartId-/item/-itemId-)

Pode verificar a lista dos parâmetros de configuração disponíveis para este artigo com esta chamada:


🇪🇺EU▾

[GET/order/cart/{cartId}/item/{itemId}/requredConfiguração](https://eu.api.ovh.com/console/?section=/order&branch=v1#get-/order/cart/-cartId-/item/-itemId-/requredConfiguração)

Utilize o seguinte endpoint para nomear o seu projeto (`label: "descrição"`):


🇪🇺EU▾

[POST/order/cart/{cartId}/item/{itemId}/configuração](https://eu.api.ovh.com/console/?section=/order&branch=v1#post-/order/cart/-cartId-/item/-itemId-/configuração)

| Campo  | Valor                 |
| ------ | --------------------- |
| CartId | _ID do seu carrinho_  |
| itemId | _ID do artigo_        |
| rótulo | descrição             |
| valor  | _Nome do seu projeto_ |

Para aplicar uma nota de compra, utilize a mesma chamada com a etiqueta "voucher", etc.

As respostas incluem uma "configuraçãoId" que pode ser utilizada (juntamente com "cartId" e "itemId") para recuperar a configuração (GET) ou para a eliminar, por exemplo:


🇪🇺EU▾

[DELETE/order/cart/{cartId}/item/{itemId}/configuração/{configuraçãoId}](https://eu.api.ovh.com/console/?section=/order&branch=v1#delete-/order/cart/-cartId-/item/-itemId-/configuração/-configuraçãoId-)

### Etapa 2: validar o carrinho

Pode verificar o conteúdo do seu carrinho através do "CartId":


🇪🇺EU▾

[GET/order/cart/{cartId}/checkout](https://eu.api.ovh.com/console/?section=/order&branch=v1#get-/order/cart/-cartId-/checkout)

A seguinte chamada permite-lhe criar um link para à sua encomenda. A casa correspondente deve ser assinalada em primeiro lugar, a fim de renunciar ao direito de retratação.


🇪🇺EU▾

[POST/order/cart/{cartId}/checkout](https://eu.api.ovh.com/console/?section=/order&branch=v1#post-/order/cart/-cartId-/checkout)

## Quer saber mais?

Fale com nossa [comunidade de utilizadores](https://community.ovhcloud.com/).