BotDetect CAPTCHA: The Simple API -- Experimental

BotDetect CAPTCHA Simple API: A Few Things to Note

  1. BotDetect CAPTCHA has two APIs:
    The Simple API, and the Traditional API -- use one or another -- never ever mix them!

  2. If you are looking for the docs of our old-school Traditional API -- click on the link here -- do not proceed with this page!

  3. If you are looking for the docs of our experimental Simple API -- do proceed with this page.

  4. BotDetect CAPTCHA is stable, indeed; but with the Simple API -- beware!
    There are reasons why the Simple API has that 'experimental' designation:

    • The Simple API itself is still a work-in-progress -- its specs are not frozen yet.
    • The vast majority of its accompanying docs are simply not up to the task yet.

..............................................................

Simple API: The Docs You Can Trust

Those docs are updated and polished -- and reasonably bug-free at the moment! Make sure that your BotDetect CAPTCHA Simple API integration efforts do start with one of them.

If you find a bug, or would like to propose a documentation improvement, please let us know.

..............................................................

Simple API: The Docs You Should Take with a Grain of Salt

In fact, a hell lot of effort went into making those docs as bug-free as possible.

However, due to the release timings, and the way we package the BotDetect archives, there are discrepancies in between the examples shipped and the examples described in those docs.

The packaging will change; and those examples will converge with what is shipped in one the upcoming minor releases. Until then, double-check everything -- and trust your common sense!

Bookmark this page and refresh it from time to time to get the situation updates.

..............................................................

Simple API: The Docs That Are Not for the Faint of Heart, Yet

If your integration effort starts with any of those docs below -- we bet it will stray to nowhere!

Those docs are neither up to date nor they have ever been polished. While they do contain quite a lot of useful bits -- overall, they are an outdated bug-ridden mess -- do not rely upon them, yet!

But, once you have your Simple API integration, as described in those step-by-step integration guides mentioned above, up and running -- they might be useful for whatever is your next step.

On 2019/04/24 we finally evicted the last Simple API docs from the Traditional API docs' tabs and dropped them all into their own documentation branch here. Over the upcoming weeks we will try hard to get them into some semi-decent shape. Until then -- welcome to the jungle :)!

Bookmark this page and refresh it from time to time to get the situation updates.