Criar links em lote
POSThttps://api.curtei.com/v1/links/bulk
POST /v1/links/bulk: até 1.000 links por chamada com resultado por item, ou até 50.000 em segundo plano. Escopo: links:write.
Mande { "links": [ {...}, {...} ] }; cada item aceita os mesmos campos do POST /links. Um item com erro não impede os outros.
Até 1.000 itens: resposta na hora
Resposta 207 Multi-Status com um resultado por item, na mesma ordem (index):
{
"summary": {
"total": 2,
"created": 1,
"failed": 1
},
"results": [
{
"index": 0,
"status": 201,
"link": {
"id": "...",
"short_url": "https://l.curtei.com/aB3xK9"
}
},
{
"index": 1,
"status": 400,
"error": {
"code": "invalid_url",
"message": "...",
"details": {
"reason": "scheme_not_allowed"
}
}
}
]
}De 1.001 a 50.000 itens: em segundo plano
- A resposta é
202com{ "id", "status": "pending", "total", "status_url" }. - Consulte
GET /links/bulk/{id}(processed,created,failed) atéstatusserdone. - Aí
results_urlé um endereço assinado, válido por 24 h e sem token, com um resultado por linha (NDJSON).
Cada destino passa pela checagem de segurança, então o lote tem um teto de URLs de destino (contando regras e variantes): 3.000 na resposta imediata e 75.000 em segundo plano. Acima disso, 400 com details.destinations e details.max.