amigoinvisibleonline.com

API de Amigo Invisible Online

¡Ahora puedes usar Agentes AI para organizar sorteos automáticamente usando nuestra API!

¿Necesitas un token? Puedes comprarlo en esta URL.

¿Cómo usar la API?

El flujo normal consiste en dos llamadas:

  1. POST para crear la configuración del sorteo y obtener el id y secret_code.
  2. PATCH para confirmar el envío de los emails usando el id y secret_code.

1. Crear sorteo (POST)

Endpoint: POST /api/v1/sorteo/

Cabeceras necesarias:

Authorization: Token $TOKEN
Content-Type: application/json

Payload de ejemplo (test_api.json):

{
  "amigos": [
    {"list_id": 1, "nombre": "Ana", "email": "ana@example.com", "exclusiones": [2], "wishlist": "https://wishlist.com/ana"},
    {"list_id": 2, "nombre": "Bob", "email": "bob@example.com", "exclusiones": [3], "wishlist": "https://wishlist.com/bob"},
    {"list_id": 3, "nombre": "Carlos", "email": "carlos@example.com", "exclusiones": [], "wishlist": ""}
  ],
  "asunto": "$NOMBRE, tu sorteo de amigo invisible",
  "cuerpo": "¡Bienvenidos al sorteo!",
  "organizador": "Organizador Test"
}

Puedes usar el archivo test_api.json como payload para la solicitud.

Ejemplo curl:

curl -s -X POST https://www.amigoinvisibleonline.com/api/v1/sorteo/ \
  -H "Authorization: Token $TOKEN" \
  -H "Content-Type: application/json" \
  -d @test_api.json \
  -o response.json

Procesar la respuesta y extraer variables en bash:

export SORTEO_ID=$(jq '.id' response.json)
export SECRET_CODE=$(jq -r '.secret_code' response.json)

Respuesta esperada:

{
  "id": 123,
  "estado": "pendiente",
  "secret_code": "ABCD12",
  "amigos": [...],
  "asunto": "$NOMBRE, tu sorteo de amigo invisible",
  "cuerpo": "¡Bienvenidos al sorteo!",
  "organizador": "Organizador Test"
}

2. Confirmar envío (PATCH)

Endpoint: PATCH /api/v1/sorteo/<id>/enviar/

Cabeceras necesarias:

Authorization: Token $TOKEN
Content-Type: application/json

Payload de ejemplo:

{
  "secret_code": "$SECRET_CODE"
}

Ejemplo curl:

curl -X PATCH https://www.amigoinvisibleonline.com/api/v1/sorteo/$SORTEO_ID/enviar/ \
  -H "Authorization: Token $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"secret_code": "'$SECRET_CODE'"}'

Respuesta esperada:

{
  "id": 123,
  "estado": "enviado",
  ...
}

Notas