Erros

A API de Ad Placement pode devolver os seguintes códigos de resposta:

Código	Descrição	Explicação
400	Pedido inválido	Indica que os dados enviados estão formatados incorretamente.
200	OK	Isto indica que o pedido está correto ou que há algumas zonas que não puderam ser encontradas. A resposta indicará quais são essas zonas.
500	Erro interno	Indica que ocorreu um erro interno, mas a causa é desconhecida. Contacte o seu Account Manager ou Sucesso do Cliente para obter ajuda.

Mensagens de erro 400

Mensagem	Explicação
Corpo JSON malformado	Erro de sintaxe
Tipo de pedido não suportado	Foi utilizado o verbo de pedido errado
Este campo está em falta	Falta um campo obrigatório
Este campo não era esperado	Foi adicionado ao pedido um parâmetro não reconhecido
Este valor deve ser do tipo X	Foi utilizado o formato errado para um parâmetro específico

Exemplo de erro 400

Pedido:

{
    "user": {
        "testing": false
    },
    "zones": [
        {
            "id": "12345"
        }
    ]
}

Resposta:

{
    "errors": [
        {
            "[user][ua]": "Este campo está em falta."
        },
        {
            "[user][testing]": "Este campo não era esperado."
        },
        {
            "[zones][0]": "[id] Este valor deve ser do tipo int."
        }
    ]
}

Mensagens de erro 200

Mensagem	Explicação
ID da zona não encontrado	O ID da zona não pode ser encontrado OU o domínio do endpoint não corresponde ao formato de anúncio pedido
Zona ou site não válido	A zona ou o editor está bloqueado.

Exemplo de erro 200

Neste exemplo, pedimos anúncios para várias zonas e algumas delas devolveram erros.

Pedido:

{
    "user": {
        "ip": "179.127.135.233",
        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:81.0) Gecko/20100101 Firefox/81.0"
    },
    "zones": [
        {
            "id": 1
        },
        {
            "id": 2
        },
        {
            "id": 3
        }   
    ]
}

Resposta:

{
    "zones": [
        null,
        {
            "idzone": 2,
            "type": "banner",
            "data": {
                "url": "https://main.example.rocks/click.php?data=H4sIAAAAAAAAA0WPO27DQAxEr.LG7YK__bBMk8ZFzrArrZAiQQLYgFzM4UNZRUCCIMjhw_ACI69SHNYIn4_H7_2qb1d5j9z3Pc1nX.9p.fkGQAAXUvGj4n_D1RNLTaw5iSpgVoQbcbCV2CsytZgyNACBCZASPSUTOAIsSQ1qlFsOVWXeNKDDZ1cuS56j5o1Gtz7K1BonhPHVI09nB_GC1_gMtcwcTl4dHd8dIqdT2k6h4eOG5kK1.7Kts.ncyuijs64unlerZf4BvX2zxCABAAA-",
                "impression": "https://syndication.example.rocks/cimp.php?t=imp&api=1&data=H4sIAAAAAAAAAzVPSW4DMQz7Sj8wBrV5ya1FX9CiD7An9qlFD73MQY+PkmlEG5ZMwqQZjI2wMb0QLpovKk6lJeKSSCyxiL99vLqSz6Nf/9L+++MqrFKeRy3aqrlCQK24oUbfCufmqpmpgpyyiyMgCqsWr8WQtHqBf32+P3aonF2Agw3R320pRJyQyBtc4xJHUJxEvRAtiaijzS6Ud5uj2MLo2keekevuMb57rEdonEj4p54QNaL45UbngHvwKPiDjqqnPPKpwstqmHNera9OZe053DCHrdGXGPUbbttiKlIBAAA=",
                "image": "https://static.example.rocks/library/432437/42ec0144a74a1663f2973ad3070234f8e5633855.jpg"
            }
        },
        null
    ],
    "errors": {
        "0": [
            "Zona 1 não encontrada"
        ],
        "2": [
            "Zona 3 não encontrada"
        ]
    }
}

zones.data null

Muito raramente, um pedido de zona de anúncios devolverá uma resposta correta, mas o data campo será null. Isto significa que o sistema não encontrou anúncios que satisfaçam o pedido dado, tendo em conta a localização do utilizador, o navegador, etc.