API REST de RastroAff: claves, permisos, endpoints y límites

La API REST da acceso por programa a lo que ves en el panel. Está incluida desde el plan Starter.

Crear una clave

En el menú API, crea una clave. Elige si puede solo leer o también escribir, y una fecha de caducidad si quieres. La clave (empieza por rst_) solo se muestra una vez: guárdala en un lugar seguro. Puedes revocarla en cualquier momento.

Envíala en la cabecera de cada petición:

curl https://rastroaff.com/api/v1/me -H "Authorization: Bearer rst_..."

Qué ve cada clave

La clave tiene el tipo y el alcance de la cuenta que la creó:

• Administrador: toda la red.
• Gestor: los afiliados que tiene asignados.
• Anunciante: sus campañas; puede registrar conversiones y enviar la actividad de los jugadores.
• Afiliado: su tráfico, sus ganancias y sus pagos.

Las cuentas de administrador necesitan la autenticación en dos pasos activada para usar la API.

Endpoints

• /api/v1/campaigns: listar, crear, editar y cambiar el estado de las ofertas.
• /api/v1/affiliates y /api/v1/advertisers: listar, ver, editar, aprobar.
• /api/v1/clicks y /api/v1/conversions: listar y, para los anunciantes, registrar conversiones.
• /api/v1/reports: el mismo motor que los informes del panel.
• /api/v1/payouts: solicitudes de pago y su estado.
• /api/v1/postbacks: el registro de los postbacks enviados.

La especificación completa (OpenAPI 3.1) está en /api/v1/openapi.json, en el idioma de la petición.

Límites y errores

• 600 peticiones por minuto por clave. Las cabeceras X-RateLimit-* indican cuántas quedan; por encima del límite, la respuesta es 429.
• Los errores vienen en JSON con un código (unauthorized, insufficient_scope, validation_error…) y un mensaje.

Para recibir eventos en lugar de ir a buscarlos, usa webhooks.