1
0
Fork 0
mirror of synced 2024-07-18 21:06:22 +12:00
appwrite/docs/sdks/dotnet/GETTING_STARTED.md

55 lines
1.8 KiB
Markdown
Raw Normal View History

2021-03-23 23:35:45 +13:00
## Getting Started
### Initialize & Make API Request
2023-07-08 00:57:44 +12:00
Once you have installed the package, it is extremely easy to get started with the SDK; all you need to do is import the package in your code, set your Appwrite credentials, and start making API calls. Below is a simple example:
2021-03-23 23:35:45 +13:00
```csharp
using Appwrite;
2023-07-08 00:57:44 +12:00
using Appwrite.Services;
using Appwrite.Models;
2021-03-23 23:35:45 +13:00
2023-07-08 00:57:44 +12:00
var client = new Client()
2023-07-08 02:34:01 +12:00
.SetEndpoint("http://cloud.appwrite.io/v1")
2023-07-08 00:57:44 +12:00
.SetProject("5ff3379a01d25") // Your project ID
2023-07-08 02:34:01 +12:00
.SetKey("cd868db89"); // Your secret API key
2021-03-23 23:35:45 +13:00
2023-07-08 00:57:44 +12:00
var users = new Users(client);
2021-03-23 23:35:45 +13:00
2023-07-08 00:57:44 +12:00
var user = await users.Create(
2023-10-18 01:49:02 +13:00
userId: ID.unique(),
email: 'email@example.com',
phone: '+123456789',
password: 'password',
name: "Walter O'Brien");
2021-03-23 23:35:45 +13:00
2023-07-08 00:57:44 +12:00
Console.WriteLine(user.ToMap());
2021-03-23 23:35:45 +13:00
```
2021-03-26 21:00:50 +13:00
### Error Handling
2023-07-08 00:57:44 +12:00
The Appwrite .NET SDK raises an `AppwriteException` object with `message`, `code`, and `response` properties. You can handle any errors by catching `AppwriteException` and presenting the `message` to the user or handling it yourself based on the provided error information. Below is an example.
2021-03-26 21:00:50 +13:00
```csharp
2023-07-08 00:57:44 +12:00
var users = new Users(client);
2021-03-26 21:00:50 +13:00
2023-07-08 00:57:44 +12:00
try
{
var user = await users.Create(
2023-10-18 01:49:02 +13:00
userId: ID.unique(),
email: 'email@example.com',
phone: '+123456789',
password: 'password',
name: "Walter O'Brien");
2023-07-08 00:57:44 +12:00
}
catch (AppwriteException e)
{
Console.WriteLine(e.Message);
2021-03-26 21:00:50 +13:00
}
```
2021-03-23 23:35:45 +13:00
### Learn more
2021-07-07 22:25:49 +12:00
You can use the following resources to learn more and get help
2021-03-23 23:35:45 +13:00
- 🚀 [Getting Started Tutorial](https://appwrite.io/docs/getting-started-for-server)
- 📜 [Appwrite Docs](https://appwrite.io/docs)
- 💬 [Discord Community](https://appwrite.io/discord)
2023-07-08 00:57:44 +12:00
- 🚂 [Appwrite .NET Playground](https://github.com/appwrite/playground-for-dotnet)