Se reestructuró la referencia de la Centro de socios de AWS API. Para obtener más información sobre las operaciones de API compatibles, consulte la referencia de la Centro de socios de AWS API.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración y autenticación

La configuración y la autenticación con la API de AWS Partner Central requieren tres pasos. Esta es una descripción general del proceso:

Vinculando sus Cuenta de AWS a Partner Central

Vincularlo Cuenta de AWS a Partner Central es un requisito previo para utilizar la API. Para obtener más información, consulta Cómo vincular las cuentas de AWS Partner Central con las cuentas de AWS Marketplace vendedor. Debes iniciar sesión en Partner Central con una cuenta que tenga permisos de administrador de nube o líder de una alianza, ir a la Account Linking sección y seguir las instrucciones.

Configuración de IAM

Para usar la API de AWS Partner Central, necesitará un rol AWS Identity and Access Management (IAM) o un usuario de IAM para empezar a realizar llamadas. Para obtener más información, consulte ¿Cuándo uso IAM? . Siga los pasos para crear roles de IAM y Crear un usuario de IAM que aparecen en las Cuenta de AWS guías correspondientes. Debes crear este IAM Role/User en tu cuenta de vendedor asociado Central-linked AWS Marketplace . La role/user creación de IAM no conlleva ningún coste.

Administración AWS Marketplace ofertas

Para gestionar las AWS Marketplace ofertas y vincularlas a las oportunidades, los socios deben conceder permiso al rol de IAM para acceder a las API del catálogo. Asegúrese de role/user que tiene permisos, como aws-marketplace:ListEntities yaws-marketplace:SearchAgreements.

Autenticar las llamadas a la API

AWS La API de Partner Central usa la versión 4 de Signature (SIGv4) para la autenticación. A continuación se explica cómo implementarla:

Uso de AWS SDK

AWS Los SDK gestionan automáticamente la firma de solicitudes. Proporcione sus AWS credenciales y el SDK se encargará del resto.

Autenticación sin usar el AWS SDK

Si el AWS SDK no está disponible para el lenguaje de programación elegido, la autenticación implica crear manualmente una solicitud canónica, firmar la solicitud y gestionar los tokens de sesión. AWS ofrece una guía completa sobre el uso de la firma de SigV4. Sin embargo, tenga en cuenta que se recomienda usar el AWS SDK, ya que la firma manual de solicitudes aumenta la complejidad y requiere una administración cuidadosa de los tokens de seguridad.

Todas las solicitudes del protocolo AWSJson1_0 DEBEN enviarse a la URL raíz (/) mediante el método HTTP «POST» y con los siguientes encabezados.

Encabezados obligatorios

Todas las solicitudes de API para el protocolo AWSJson1_0 DEBEN enviarse a la URL raíz (/) mediante el método HTTP «POST» y con los siguientes encabezados.

Firma tus llamadas con un agente de usuario personalizado

Al realizar solicitudes de API a AWS Partner Central, recomendamos incluir el X-Amzn-User-Agent encabezado para ayudar a AWS identificar el origen de la aplicación cliente, supervisar el uso y auditar el rendimiento. AWS utiliza este encabezado para distinguir el tipo de aplicación cliente que realiza la llamada y para recopilar información sobre la tasa de éxito de las diferentes implementaciones de clientes.

Encabezado usuario-agente personalizado

Nombre del encabezado: X-Amzn-User-Agent

Propósito: distingue el tipo de cliente que realiza la solicitud a la API y clasifica el origen de la interacción.

Formato: {Integrator}|{Product}

Valor de ejemplo: AWS|AWS Partner CRM Connector

La inclusión de este encabezado en cada solicitud permite AWS analizar los patrones de solicitud, realizar un seguimiento de las integraciones y mejorar la experiencia de la API en los diferentes sistemas de clientes.

Uso de encabezados personalizados en los SDK

Para incluir el X-Amzn-User-Agent encabezado en las llamadas al SDK, puedes modificar el comportamiento de las solicitudes del cliente antes de realizar la llamada a la API. A continuación, se muestra un ejemplo de venta de una API con el AWS SDK para Python (Boto3):

# Requires the AWS SDK for Python (Boto3)
import boto3

# Define service and endpoint details
service_name = "partnercentral-selling"
endpoint_url = "https://partnercentral-selling.us-east-1.api.aws"

# Create a boto3 client for Partner Central
partner_central_client = boto3.client(
service_name=service_name,
region_name='us-east-1',
endpoint_url=endpoint_url
)

# Function to add the custom User-Agent header

def add_version_header(params, **kwargs):
params["headers"]['X-Amzn-User-Agent'] = 'AWS|AWS Partner CRM Connector'

# Register the event to modify the request before the call is made
partner_central_client.meta.events.register(
f'before-call.{service_name}.*', add_version_header
)

# Now, whenever an API call is made using this client, the custom User-Agent header will be included

En este ejemplo, se muestra cómo registrar un evento en el SDK de Boto3 para añadir automáticamente el encabezado a cada solicitud de API. X-Amzn-User-Agent El mismo enfoque se puede aplicar a otros AWS SDK modificando sus respectivos mecanismos de interceptación de solicitudes.