^{Originally posted by pooranjoyb July 26, 2025}

Few things to know before writing a new API for the SDK :

• C++ SDK doesn't officially exist for Appwrite, hence we're doing it ourselves.
• We'll have to maintain the code-quality and SDK structure that Appwrite follows in their SDK repositories.
• Coding's gonna be hard, so learn basic OOPs concepts.

Now say we need to write a new api called getTopic which is a part of Messaging module.

• Firstly we'll check the Official API reference how they're calling the API.
• Then, we'll go to existing Appwrite SDKs repository (say Python-SDK, JS-SDK) and see how they've implemented that API.

For your reference
https://github.com/appwrite/sdk-for-python/blob/503de4b759c7b2611281c019d78e11aed47644f0/appwrite/services/messaging.py#L1881-L1911

• Once we get an idea of the parameters/api-endpoint etc; we'll start writing our own api-code.
• Based on our research of the API we're working on, we'll declare the API in the respective module with necessary parameters.

For your reference

• Now we'll write the API to getTopics from the Appwrite Console.

For your reference

• Now we'd need to test the API that we've created, hence we'll create an example-file.cpp to verify it's working.

For your reference

• Okay, at this point we're all set to test the API, but before that we need to add an entry to the Makefile, to compile and test it.

For your reference

• Now we'll compile and run our API.

  # Linux make getTopic

  # Windows mingw32-make getTopic

• This will create the binary for the API in ./tests/ directory.

• Finally we'll run our API and debug it further based on my requirement.

cd tests/ ./getTopic

Summary

You’ve now:

• Investigated the API from the docs and SDKs
• Declared and implemented the getTopic API
• Created a test case
• Updated the build pipeline
• Successfully compiled and executed your implementation

🎉 You’ve added a new API to the C++ Appwrite SDK!