Files
neocities-c/README.md
2026-02-23 08:31:26 -03:00

1.1 KiB
Executable File

Neocities API C library

Minimal, secure C wrapper for the Neocities API.


Features

  • Site info retrieval
  • File listing
  • Upload files
  • Delete files
  • Get API key
  • TLS verification enabled by default

Requirements

  • libcurl

Linux (example):

sudo apt install libcurl4-openssl-dev

API Overview

Info (public)

int neocities_info(const char *sitename, char **out);

Fetch metadata about a site.


List files

int neocities_list(const char *api_key, const char *path, char** out);

List files at a path.


Upload

int neocities_upload(const char *api_key, const char **local_files, const char **remote_names, size_t count, char **response);

Uploads multiple files.

  • local_files[i] → local path
  • remote_names[i] → remote filename

Delete

int neocities_delete(const char *api_key, const char **filenames, size_t count, char **response);

Deletes files from the site.


API Key

int neocities_apikey(const char *user, const char *pass, char **out);

Get your API key.


Example Usage

See example.c


License

MIT