Documentation

Documentation

  • General
  • Advertisers
  • Publishers
  • RTB
  • API
  • News

›Ad Placement API

EXADS Public API

  • API Overview
  • Developer API
  • Versions
  • API Interface
  • HTTP Headers
  • HTTP Verbs
  • Returned Data Standard Types
  • Errors
  • Macros
  • Pagination
  • Rate Limiting
  • Global Statistics API
  • PHP Examples

Ad Placement API

  • Ad Placement API Overview
  • Request
  • Response
  • Errors
  • Error Examples
  • Renderers

Conversion Tracking API

  • Conversion Tracking API

Error Examples

Zone ID not recognised

In the example below we have requested ads for multiple zones and returned errors for some zones. The zone id was not found for two of them.

 

Request: JSON

{
    "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": 4030198
        },
        {
            "id": 4030197
        },
        {
            "id": 4030194
        }   
    ]
}

 

Response: JSON

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

 

Zone contains unacceptable field

In this case the request contains the unacceptable field "testing".

Request: JSON

{
    "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": 4030197,
            "testing": false
        }
    ]
}

 

Response: JSON

{
    "errors": [
        {
            "[zones][0][testing]": "This field was not expected."
        }
    ]
}

 

Required field missing and incorrect field added

In this example, the request is missing the required field "ip", and contains the unacceptable field "testing".

 

Request: JSON

{
    "user": {
        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:81.0) Gecko/20100101 Firefox/81.0",
        "testing": false
    },
    "zones": [
        {
            "id": 4030197
        }
    ]
}

 

Response: JSON

{
    "errors": [
        {
            "[user][ip]": "This field is missing."
        },
        {
            "[user][testing]": "This field was not expected."
        }
    ]
}

← ErrorsRenderers →
  • Zone ID not recognised
    • Request: JSON
    • Response: JSON
  • Zone contains unacceptable field
    • Request: JSON
    • Response: JSON
  • Required field missing and incorrect field added
    • Request: JSON
    • Response: JSON
Documentation
Community
Github
Useful Links
EXADS
Copyright © 2025 EXADS