Erros

A API de colocação de anúncios pode devolver os seguintes códigos de resposta:

Código	Descrição	Explicação
400	Mau pedido	Indica que os dados enviados estão incorretamente formatados.
200	OK	Isto indica que o pedido está correto ou que há algumas zonas que não foram encontradas. A resposta dir-lhe-á quais são essas zonas.
500	Erro interno	Indica que ocorreu um erro interno, mas a causa é desconhecida. Contacte o seu gestor de conta ou Customer Success para obter ajuda.

400 Mensagens de erro

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

exemplo de erro 400

Pedido:

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

Resposta:

{
    "errors": [
        {
            "[user][ua]": "This field is missing."
        },
        {
            "[user][testing]": "This field was not expected."
        },
        {
            "[zones][0]": "[id] This value should be of type 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 ponto final não corresponde ao formato de anúncio solicitado
Zona ou sítio não válido	A zona ou o editor está bloqueado.

exemplo de erro 200

Neste exemplo, solicitámos 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": [
            "Zone 1 not found"
        ],
        "2": [
            "Zone 3 not found"
        ]
    }
}

zonas.data null

Muito raramente, um pedido de zona de anúncios devolverá uma resposta correta, mas o campo "dados" será nulo. Isto significa que o sistema não encontrou anúncios que satisfizessem o pedido dado, tendo em conta a localidade do utilizador, o browser, etc.