Atualiza os dados de uma aplicação específica vinculada ao parceiro autenticado.
Token de autenticação obtido no login do parceiro.
stringID da aplicação que será atualizada.
stringCabeçalhos obrigatórios:
| Cabeçalho | Valor | Descrição |
|---|---|---|
Content-Type | application/json | Tipo de conteúdo enviado no corpo da requisição. |
Authorization | Bearer {{ access_token }} | Token de autenticação obtido no login do parceiro. |
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Sim | Novo nome da aplicação. |
scopes | array | Sim | Lista de escopos autorizados para a aplicação. |
description | string | Sim | Descrição detalhada da aplicação. |
briefing | string | Sim | Descrição resumida da aplicação. |
category | string | Sim | Categoria atribuída à aplicação. |
| Escopo | Descrição |
|---|---|
cob.read | Leitura de cobranças Pix |
cob.write | Criação e atualização de cobranças Pix |
merchants.read | Leitura de estabelecimentos |
merchants.write | Criação e atualização de estabelecimentos |
terminals.read | Leitura de terminais |
terminals.write | Criação e atualização de terminais |
transactions.read | Leitura de transações |
transactions.write | Criação e atualização de transações |
webhooks.read | Leitura de webhooks |
webhooks.write | Criação e atualização de webhooks |
dict.read | Leitura de dicionários |
dict.write | Criação e atualização de dicionários |
Em caso de sucesso, será retornado um objeto JSON com os dados atualizados da aplicação, incluindo campos como id, name, scopes, status, datas e informações do parceiro.
| Campo | Tipo | Descrição |
|---|---|---|
id | string | ID único da aplicação atualizada. |
partner | object | Dados do parceiro proprietário da aplicação. |
name | string | Nome atualizado da aplicação. |
description | string | Descrição atualizada da aplicação. |
briefing | string | Descrição resumida atualizada da aplicação. |
category | string | Categoria atualizada da aplicação. |
scopes | array | Escopos atualizados da aplicação. |
client_id | string | ID do cliente (se aplicação estiver aprovada). |
client_secret | string | Chave secreta do cliente (se aplicação estiver aprovada). |
status | string | Status atual da aplicação. |
created_at | string | Data de criação da aplicação (ISO8601). |
updated_at | string | Data da última atualização da aplicação (ISO8601). |
{{ access_token }} deve ser válido e obtido via login do parceiro.partnerApplicationId deve ser o ID da aplicação que deseja atualizar.active podem ter suas credenciais afetadas por mudanças nos escopos.| Código | Significado | Descrição |
|---|---|---|
| 200 | OK | Aplicação atualizada com sucesso. |
| 400 | Bad Request | Parâmetros inválidos ou ausentes na requisição. |
| 401 | Unauthorized | Token de autenticação inválido ou expirado. |
| 403 | Forbidden | Parceiro não tem permissão para atualizar esta aplicação. |
| 404 | Not Found | Aplicação não encontrada. |
| 500 | Internal Server Error | Erro interno do servidor. |
{{ access_token }} deve ser válido e obtido via login do parceiro.partnerApplicationId deve ser o ID da aplicação que deseja atualizar.curl --location --globoff --request PATCH 'https://dominio-ambiente.com.br/api/v2/partners/application/{{ partner_application_id }}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{ access_token }}' \
--data '{
"name": "Novo nome da sua aplicação",
"scopes": [
"cob.read",
"cob.write"
],
"description": "Uma descrição da sua aplicação",
"briefing": "Uma descrição curta da sua aplicação",
"category": "Categoria 1"
}'
const axios = require('axios');
const updateApplication = async (token, applicationId, updateData) => {
try {
const response = await axios.patch(`https://dominio-ambiente.com.br/api/v2/partners/application/${applicationId}`, updateData, {
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${token}`
}
});
console.log('Aplicação atualizada:', response.data.id);
console.log('Nome:', response.data.name);
console.log('Status:', response.data.status);
return response.data;
} catch (error) {
console.error('Erro ao atualizar aplicação:', error.response?.data || error.message);
return null;
}
};
// Exemplo de uso
const applicationId = "{{ partner_application_id }}";
const updateData = {
name: "Novo nome da sua aplicação",
scopes: ["cob.read", "cob.write"],
description: "Uma descrição da sua aplicação",
briefing: "Uma descrição curta da sua aplicação",
category: "Categoria 1"
};
const token = "{{ access_token }}";
updateApplication(token, applicationId, updateData);
import requests
import json
def update_application(token, application_id, update_data):
url = f"https://dominio-ambiente.com.br/api/v2/partners/application/{application_id}"
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {token}"
}
try:
response = requests.patch(url, json=update_data, headers=headers)
response.raise_for_status()
data = response.json()
print(f"Aplicação atualizada: {data['id']}")
print(f"Nome: {data['name']}")
print(f"Status: {data['status']}")
print(f"Escopos: {', '.join(data['scopes'])}")
return data
except requests.exceptions.RequestException as e:
print(f"Erro na requisição: {e}")
return None
# Exemplo de uso
application_id = "{{ partner_application_id }}"
update_data = {
"name": "Novo nome da sua aplicação",
"scopes": ["cob.read", "cob.write"],
"description": "Uma descrição da sua aplicação",
"briefing": "Uma descrição curta da sua aplicação",
"category": "Categoria 1"
}
token = "{{ access_token }}"
result = update_application(token, application_id, update_data)
<?php
function updateApplication($token, $applicationId, $updateData) {
$url = 'https://dominio-ambiente.com.br/api/v2/partners/application/' . $applicationId;
// Configuração do cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($updateData));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer ' . $token
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);
curl_close($ch);
if ($error) {
echo "Erro cURL: " . $error . "\n";
return null;
}
if ($httpCode !== 200 && $httpCode !== 201) {
echo "Erro HTTP: " . $httpCode . "\n";
echo "Resposta: " . $response . "\n";
return null;
}
$data = json_decode($response, true);
if (json_last_error() !== JSON_ERROR_NONE) {
echo "Erro ao decodificar JSON: " . json_last_error_msg() . "\n";
return null;
}
echo "Aplicação atualizada: " . $data['id'] . "\n";
echo "Nome: " . $data['name'] . "\n";
echo "Status: " . $data['status'] . "\n";
return $data;
}
// Exemplo de uso
$applicationId = '{{ partner_application_id }}';
$updateData = [
'name' => 'Novo nome da sua aplicação',
'scopes' => ['cob.read', 'cob.write'],
'description' => 'Uma descrição da sua aplicação',
'briefing' => 'Uma descrição curta da sua aplicação',
'category' => 'Categoria 1'
];
$token = '{{ access_token }}';
updateApplication($token, $applicationId, $updateData);
?>
{
"id": "app-123-456-789",
"partner": {
"id": "partner-abc-def",
"name": "Minha Empresa",
"contact_email": "[email protected]",
"contact_phone": "11999999999",
"status": "active",
"scopes": ["cob.read", "cob.write", "merchants.read"]
},
"name": "Novo nome da sua aplicação",
"description": "Uma descrição da sua aplicação",
"briefing": "Uma descrição curta da sua aplicação",
"category": "Categoria 1",
"scopes": [
"cob.read",
"cob.write"
],
"client_id": "client_123456789",
"client_secret": "secret_987654321",
"status": "active",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-20T14:45:00Z"
}