Pular para o conteúdo
AchaduDevelopers
API operacionalIr para o site ↗
Painel →
Developers/API/link_convert
Links

Converter link

Converte uma URL usando apenas as integrações desta conta.

POST/links/convertlinks:write
COMPORTAMENTO

A alteração é validada e persistida na conta da chave antes da resposta. Consulte o recurso retornado como fonte de verdade.

EFEITO

Pode alterar o recurso e emitir o evento de domínio correspondente.

REPETIÇÃO

Em falha de rede, confirme o estado do recurso antes de repetir. Refaça automaticamente apenas 429 e 5xx com backoff e jitter.

Solicitação

urlstring · bodyURL HTTPS do produto.uri · maxLength 2000obrigatório
AuthorizationBearer ach_live_...
Acceptapplication/json
Escopolinks:write

Exemplo executável

curl
curl -X POST 'https://achadu.com/api/v1/links/convert' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "url": "https://example.com/product"
}'

Resposta e erros

Toda resposta inclui request_id. Listas acrescentam pagination; recursos mutáveis retornam o estado persistido após a operação.

200 application/json
{
  "data": {
    "url": "https://example.com/product?tag=affiliate",
    "marketplace": "amazon",
    "missing_commission": false,
    "warning": null
  },
  "request_id": "req_01J..."
}
200Operação concluída.
400Parâmetro, corpo ou transição inválida.
401Chave ausente, inválida, expirada ou revogada.
402O plano da conta não libera esta interface.
403A chave precisa do escopo links:write.
404Recurso inexistente nesta conta.
409O estado atual impede esta operação.
413O corpo JSON ultrapassa 128 KB.
429A janela de 120 solicitações por minuto foi excedida.