Delta Chat Core C Interface
Loading...
Searching...
No Matches
deltachat.h
1#ifndef __DELTACHAT_H__
2#define __DELTACHAT_H__
3#ifdef __cplusplus
4extern "C" {
5#endif
6
7
8#ifndef PY_CFFI
9#include <stdint.h>
10#include <time.h>
11#endif
12
13
14typedef struct _dc_context dc_context_t;
15typedef struct _dc_accounts dc_accounts_t;
16typedef struct _dc_array dc_array_t;
17typedef struct _dc_chatlist dc_chatlist_t;
18typedef struct _dc_chat dc_chat_t;
19typedef struct _dc_msg dc_msg_t;
20typedef struct _dc_contact dc_contact_t;
21typedef struct _dc_lot dc_lot_t;
22typedef struct _dc_provider dc_provider_t;
23typedef struct _dc_event dc_event_t;
24typedef struct _dc_event_emitter dc_event_emitter_t;
25typedef struct _dc_jsonrpc_instance dc_jsonrpc_instance_t;
26typedef struct _dc_backup_provider dc_backup_provider_t;
27
28// Alias for backwards compatibility, use dc_event_emitter_t instead.
29typedef struct _dc_event_emitter dc_accounts_event_emitter_t;
30
235
236
246
247// create/open/config/information
248
264dc_context_t* dc_context_new (const char* os_name, const char* dbfile, const char* blobdir);
265
266
283
284
299int dc_context_open (dc_context_t *context, const char* passphrase);
300
301
312int dc_context_change_passphrase (dc_context_t* context, const char* passphrase);
313
314
323
324
337
338
350uint32_t dc_get_id (dc_context_t* context);
351
352
373
374
383char* dc_get_blobdir (const dc_context_t* context);
384
385
538int dc_set_config (dc_context_t* context, const char* key, const char* value);
539
540
566char* dc_get_config (dc_context_t* context, const char* key);
567
568
580int dc_set_stock_translation(dc_context_t* context, uint32_t stock_id, const char* stock_msg);
581
582
597int dc_set_config_from_qr (dc_context_t* context, const char* qr);
598
599
614char* dc_get_info (const dc_context_t* context);
615
616
646char* dc_get_oauth2_url (dc_context_t* context, const char* addr, const char* redirect_uri);
647
648
649#define DC_CONNECTIVITY_NOT_CONNECTED 1000
650#define DC_CONNECTIVITY_CONNECTING 2000
651#define DC_CONNECTIVITY_WORKING 3000
652#define DC_CONNECTIVITY_CONNECTED 4000
653
654
676
677
694
695
696#define DC_PUSH_NOT_CONNECTED 0
697#define DC_PUSH_HEARTBEAT 1
698#define DC_PUSH_CONNECTED 2
699
712
713
714// connect
715
767
768
788int dc_is_configured (const dc_context_t* context);
789
790
801void dc_start_io (dc_context_t* context);
802
818
842
843
844
860int dc_preconfigure_keypair (dc_context_t* context, const char *secret_data);
861
862
863// handle chatlists
864
865#define DC_GCL_ARCHIVED_ONLY 0x01
866#define DC_GCL_NO_SPECIALS 0x02
867#define DC_GCL_ADD_ALLDONE_HINT 0x04
868#define DC_GCL_FOR_FORWARDING 0x08
869
870
920dc_chatlist_t* dc_get_chatlist (dc_context_t* context, int flags, const char* query_str, uint32_t query_id);
921
922
923// handle chats
924
938uint32_t dc_create_chat_by_contact_id (dc_context_t* context, uint32_t contact_id);
939
940
952uint32_t dc_get_chat_id_by_contact_id (dc_context_t* context, uint32_t contact_id);
953
954
990uint32_t dc_send_msg (dc_context_t* context, uint32_t chat_id, dc_msg_t* msg);
991
1006uint32_t dc_send_msg_sync (dc_context_t* context, uint32_t chat_id, dc_msg_t* msg);
1007
1008
1028uint32_t dc_send_text_msg (dc_context_t* context, uint32_t chat_id, const char* text_to_send);
1029
1030
1045void dc_send_edit_request (dc_context_t* context, uint32_t msg_id, const char* new_text);
1046
1047
1060 void dc_send_delete_request (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);
1061
1062
1096uint32_t dc_send_videochat_invitation (dc_context_t* context, uint32_t chat_id);
1097
1098
1131int dc_send_webxdc_status_update (dc_context_t* context, uint32_t msg_id, const char* json, const char* descr);
1132
1133
1164char* dc_get_webxdc_status_updates (dc_context_t* context, uint32_t msg_id, uint32_t serial);
1165
1166
1177void dc_set_webxdc_integration (dc_context_t* context, const char* file);
1178
1179
1222uint32_t dc_init_webxdc_integration (dc_context_t* context, uint32_t chat_id);
1223
1224
1248void dc_set_draft (dc_context_t* context, uint32_t chat_id, dc_msg_t* msg);
1249
1250
1298uint32_t dc_add_device_msg (dc_context_t* context, const char* label, dc_msg_t* msg);
1299
1310int dc_was_device_msg_ever_added (dc_context_t* context, const char* label);
1311
1312
1325dc_msg_t* dc_get_draft (dc_context_t* context, uint32_t chat_id);
1326
1327
1328#define DC_GCM_ADDDAYMARKER 0x01
1329#define DC_GCM_INFO_ONLY 0x02
1330
1331
1352dc_array_t* dc_get_chat_msgs (dc_context_t* context, uint32_t chat_id, uint32_t flags, uint32_t marker1before);
1353
1354
1363int dc_get_msg_cnt (dc_context_t* context, uint32_t chat_id);
1364
1365
1383int dc_get_fresh_msg_cnt (dc_context_t* context, uint32_t chat_id);
1384
1385
1399
1400
1415int dc_estimate_deletion_cnt (dc_context_t* context, int from_server, int64_t seconds);
1416
1417
1437
1438
1462
1463
1487
1488
1502void dc_marknoticed_chat (dc_context_t* context, uint32_t chat_id);
1503
1504
1523dc_array_t* dc_get_chat_media (dc_context_t* context, uint32_t chat_id, int msg_type, int msg_type2, int msg_type3);
1524
1525
1537void dc_set_chat_visibility (dc_context_t* context, uint32_t chat_id, int visibility);
1538
1539
1565void dc_delete_chat (dc_context_t* context, uint32_t chat_id);
1566
1580void dc_block_chat (dc_context_t* context, uint32_t chat_id);
1581
1594void dc_accept_chat (dc_context_t* context, uint32_t chat_id);
1595
1618dc_array_t* dc_get_chat_contacts (dc_context_t* context, uint32_t chat_id);
1619
1630char* dc_get_chat_encrinfo (dc_context_t* context, uint32_t chat_id);
1631
1643uint32_t dc_get_chat_ephemeral_timer (dc_context_t* context, uint32_t chat_id);
1644
1667dc_array_t* dc_search_msgs (dc_context_t* context, uint32_t chat_id, const char* query);
1668
1669
1680dc_chat_t* dc_get_chat (dc_context_t* context, uint32_t chat_id);
1681
1682
1683// handle group chats
1684
1712uint32_t dc_create_group_chat (dc_context_t* context, int protect, const char* name);
1713
1714
1731
1732
1743int dc_is_contact_in_chat (dc_context_t* context, uint32_t chat_id, uint32_t contact_id);
1744
1745
1762int dc_add_contact_to_chat (dc_context_t* context, uint32_t chat_id, uint32_t contact_id);
1763
1764
1779int dc_remove_contact_from_chat (dc_context_t* context, uint32_t chat_id, uint32_t contact_id);
1780
1781
1796int dc_set_chat_name (dc_context_t* context, uint32_t chat_id, const char* name);
1797
1815int dc_set_chat_ephemeral_timer (dc_context_t* context, uint32_t chat_id, uint32_t timer);
1816
1836int dc_set_chat_profile_image (dc_context_t* context, uint32_t chat_id, const char* image);
1837
1838
1839
1861int dc_set_chat_mute_duration (dc_context_t* context, uint32_t chat_id, int64_t duration);
1862
1863// handle messages
1864
1877char* dc_get_msg_info (dc_context_t* context, uint32_t msg_id);
1878
1879
1927char* dc_get_msg_html (dc_context_t* context, uint32_t msg_id);
1928
1929
1949void dc_download_full_msg (dc_context_t* context, int msg_id);
1950
1951
1961void dc_delete_msgs (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);
1962
1963
1978void dc_forward_msgs (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt, uint32_t chat_id);
1979
1980
2008void dc_save_msgs (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);
2009
2010
2027int dc_resend_msgs (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);
2028
2029
2060void dc_markseen_msgs (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);
2061
2062
2075dc_msg_t* dc_get_msg (dc_context_t* context, uint32_t msg_id);
2076
2077
2078// handle contacts
2079
2093int dc_may_be_valid_addr (const char* addr);
2094
2095
2109uint32_t dc_lookup_contact_id_by_addr (dc_context_t* context, const char* addr);
2110
2111
2132uint32_t dc_create_contact (dc_context_t* context, const char* name, const char* addr);
2133
2134
2135
2136// Deprecated 2025-05-20, setting this flag is a no-op.
2137#define DC_GCL_DEPRECATED_VERIFIED_ONLY 0x01
2138
2139#define DC_GCL_ADD_SELF 0x02
2140
2141
2165int dc_add_address_book (dc_context_t* context, const char* addr_book);
2166
2167
2176char* dc_make_vcard (dc_context_t* context, uint32_t contact_id);
2177
2178
2188dc_array_t* dc_import_vcard (dc_context_t* context, const char* vcard);
2189
2190
2205dc_array_t* dc_get_contacts (dc_context_t* context, uint32_t flags, const char* query);
2206
2207
2217
2218
2228
2229
2239void dc_block_contact (dc_context_t* context, uint32_t contact_id, int block);
2240
2241
2252char* dc_get_contact_encrinfo (dc_context_t* context, uint32_t contact_id);
2253
2254
2267int dc_delete_contact (dc_context_t* context, uint32_t contact_id);
2268
2269
2283dc_contact_t* dc_get_contact (dc_context_t* context, uint32_t contact_id);
2284
2285
2286// import/export and tools
2287
2288#define DC_IMEX_EXPORT_SELF_KEYS 1 // param1 is a directory where the keys are written to
2289#define DC_IMEX_IMPORT_SELF_KEYS 2 // param1 is a directory where the keys are searched in and read from
2290#define DC_IMEX_EXPORT_BACKUP 11 // param1 is a directory where the backup is written to, param2 is a passphrase to encrypt the backup
2291#define DC_IMEX_IMPORT_BACKUP 12 // param1 is the file with the backup to import, param2 is the backup's passphrase
2292
2293
2338void dc_imex (dc_context_t* context, int what, const char* param1, const char* param2);
2339
2340
2390char* dc_imex_has_backup (dc_context_t* context, const char* dir);
2391
2392
2438
2439
2460int dc_continue_key_transfer (dc_context_t* context, uint32_t msg_id, const char* setup_code);
2461
2462
2480
2481
2482// out-of-band verification
2483
2484#define DC_QR_ASK_VERIFYCONTACT 200 // id=contact
2485#define DC_QR_ASK_VERIFYGROUP 202 // text1=groupname
2486#define DC_QR_FPR_OK 210 // id=contact
2487#define DC_QR_FPR_MISMATCH 220 // id=contact
2488#define DC_QR_FPR_WITHOUT_ADDR 230 // test1=formatted fingerprint
2489#define DC_QR_ACCOUNT 250 // text1=domain
2490#define DC_QR_BACKUP 251 // deprecated
2491#define DC_QR_BACKUP2 252
2492#define DC_QR_BACKUP_TOO_NEW 255
2493#define DC_QR_WEBRTC_INSTANCE 260 // text1=domain, text2=instance pattern
2494#define DC_QR_PROXY 271 // text1=address (e.g. "127.0.0.1:9050")
2495#define DC_QR_ADDR 320 // id=contact
2496#define DC_QR_TEXT 330 // text1=text
2497#define DC_QR_URL 332 // text1=URL
2498#define DC_QR_ERROR 400 // text1=error string
2499#define DC_QR_WITHDRAW_VERIFYCONTACT 500
2500#define DC_QR_WITHDRAW_VERIFYGROUP 502 // text1=groupname
2501#define DC_QR_REVIVE_VERIFYCONTACT 510
2502#define DC_QR_REVIVE_VERIFYGROUP 512 // text1=groupname
2503#define DC_QR_LOGIN 520 // text1=email_address
2504
2600dc_lot_t* dc_check_qr (dc_context_t* context, const char* qr);
2601
2602
2626char* dc_get_securejoin_qr (dc_context_t* context, uint32_t chat_id);
2627
2628
2642char* dc_get_securejoin_qr_svg (dc_context_t* context, uint32_t chat_id);
2643
2667uint32_t dc_join_securejoin (dc_context_t* context, const char* qr);
2668
2669
2670// location streaming
2671
2672
2689void dc_send_locations_to_chat (dc_context_t* context, uint32_t chat_id, int seconds);
2690
2691
2705int dc_is_sending_locations_to_chat (dc_context_t* context, uint32_t chat_id);
2706
2707
2735int dc_set_location (dc_context_t* context, double latitude, double longitude, double accuracy);
2736
2737
2798dc_array_t* dc_get_locations (dc_context_t* context, uint32_t chat_id, uint32_t contact_id, int64_t timestamp_begin, int64_t timestamp_end);
2799
2800
2812
2813
2814// misc
2815
2827char* dc_create_qr_svg (const char* payload);
2828
2829
2844
2845
2858void dc_str_unref (char* str);
2859
2860
2866
2890
2891
2910
2911
2927
2938
2953
2977int dc_receive_backup (dc_context_t* context, const char* qr);
2978
3005
3028dc_accounts_t* dc_accounts_new (const char* dir, int writable);
3029
3030
3038
3039
3056
3073
3088uint32_t dc_accounts_migrate_account (dc_accounts_t* accounts, const char* dbfile);
3089
3090
3102int dc_accounts_remove_account (dc_accounts_t* accounts, uint32_t account_id);
3103
3104
3114
3115
3127dc_context_t* dc_accounts_get_account (dc_accounts_t* accounts, uint32_t account_id);
3128
3129
3146
3147
3156int dc_accounts_select_account (dc_accounts_t* accounts, uint32_t account_id);
3157
3158
3169
3170
3180
3181
3192
3193
3207
3208
3224int dc_accounts_background_fetch (dc_accounts_t* accounts, uint64_t timeout);
3225
3226
3234void dc_accounts_set_push_device_token (dc_accounts_t* accounts, const char *token);
3235
3256
3257
3266
3267
3277
3278
3286size_t dc_array_get_cnt (const dc_array_t* array);
3287
3288
3297uint32_t dc_array_get_id (const dc_array_t* array, size_t index);
3298
3299
3309double dc_array_get_latitude (const dc_array_t* array, size_t index);
3310
3311
3321double dc_array_get_longitude (const dc_array_t* array, size_t index);
3322
3323
3334double dc_array_get_accuracy (const dc_array_t* array, size_t index);
3335
3336
3346int64_t dc_array_get_timestamp (const dc_array_t* array, size_t index);
3347
3348
3358uint32_t dc_array_get_chat_id (const dc_array_t* array, size_t index);
3359
3360
3370uint32_t dc_array_get_contact_id (const dc_array_t* array, size_t index);
3371
3372
3382uint32_t dc_array_get_msg_id (const dc_array_t* array, size_t index);
3383
3384
3399char* dc_array_get_marker (const dc_array_t* array, size_t index);
3400
3401
3412int dc_array_is_independent (const dc_array_t* array, size_t index);
3413
3414
3424int dc_array_search_id (const dc_array_t* array, uint32_t needle, size_t* ret_index);
3425
3426
3459
3460
3469
3470
3478size_t dc_chatlist_get_cnt (const dc_chatlist_t* chatlist);
3479
3480
3492uint32_t dc_chatlist_get_chat_id (const dc_chatlist_t* chatlist, size_t index);
3493
3494
3506uint32_t dc_chatlist_get_msg_id (const dc_chatlist_t* chatlist, size_t index);
3507
3508
3535dc_lot_t* dc_chatlist_get_summary (const dc_chatlist_t* chatlist, size_t index, dc_chat_t* chat);
3536
3537
3557dc_lot_t* dc_chatlist_get_summary2 (dc_context_t* context, uint32_t chat_id, uint32_t msg_id);
3558
3559
3568
3569
3586char* dc_chat_get_info_json (dc_context_t* context, size_t chat_id);
3587
3596
3597
3598#define DC_CHAT_ID_TRASH 3 // messages that should be deleted get this chat ID; the messages are deleted from the working thread later then. This is also needed as rfc724_mid should be preset as long as the message is not deleted on the server (otherwise it is downloaded again)
3599#define DC_CHAT_ID_ARCHIVED_LINK 6 // only an indicator in a chatlist
3600#define DC_CHAT_ID_ALLDONE_HINT 7 // only an indicator in a chatlist
3601#define DC_CHAT_ID_LAST_SPECIAL 9 // larger chat IDs are "real" chats, their messages are "real" messages
3602
3603
3612
3613
3626uint32_t dc_chat_get_id (const dc_chat_t* chat);
3627
3628
3659int dc_chat_get_type (const dc_chat_t* chat);
3660
3661
3673
3674
3686char* dc_chat_get_name (const dc_chat_t* chat);
3687
3688
3703
3704
3717uint32_t dc_chat_get_color (const dc_chat_t* chat);
3718
3719
3729
3730
3748
3749
3771
3772
3782
3783
3799
3800
3812int dc_chat_can_send (const dc_chat_t* chat);
3813
3814
3839
3840
3854
3855
3874
3875
3887
3888
3896int dc_chat_is_muted (const dc_chat_t* chat);
3897
3898
3907
3908
3916
3917
3918#define DC_MSG_ID_MARKER1 1 // this is used by iOS to mark things in the message list
3919#define DC_MSG_ID_DAYMARKER 9
3920#define DC_MSG_ID_LAST_SPECIAL 9
3921
3922
3935dc_msg_t* dc_msg_new (dc_context_t* context, int viewtype);
3936
3937
3946
3947
3956uint32_t dc_msg_get_id (const dc_msg_t* msg);
3957
3958
3973uint32_t dc_msg_get_from_id (const dc_msg_t* msg);
3974
3975
3984uint32_t dc_msg_get_chat_id (const dc_msg_t* msg);
3985
3986
3996
3997
4041
4042
4059int64_t dc_msg_get_timestamp (const dc_msg_t* msg);
4060
4061
4074
4075
4090
4091
4111char* dc_msg_get_text (const dc_msg_t* msg);
4112
4113
4131char* dc_msg_get_subject (const dc_msg_t* msg);
4132
4133
4147char* dc_msg_get_file (const dc_msg_t* msg);
4148
4149
4160int dc_msg_save_file (const dc_msg_t* msg, const char* path);
4161
4162
4173
4174
4186
4187
4200char* dc_msg_get_webxdc_blob (const dc_msg_t* msg, const char* filename, size_t* ret_bytes);
4201
4202
4239
4240
4251uint64_t dc_msg_get_filebytes (const dc_msg_t* msg);
4252
4253
4269
4270
4286
4287
4300
4301
4310
4320int dc_msg_is_bot (const dc_msg_t* msg);
4321
4334
4348
4349
4373
4374
4386char* dc_msg_get_summarytext (const dc_msg_t* msg, int approx_characters);
4387
4388
4418
4419
4420
4436
4437
4448
4449
4460int dc_msg_is_sent (const dc_msg_t* msg);
4461
4462
4480
4481
4493 int dc_msg_is_edited (const dc_msg_t* msg);
4494
4495
4516int dc_msg_is_info (const dc_msg_t* msg);
4517
4518
4551
4552
4574
4575
4576// DC_INFO* uses the same values as SystemMessage in rust-land
4577#define DC_INFO_UNKNOWN 0
4578#define DC_INFO_GROUP_NAME_CHANGED 2
4579#define DC_INFO_GROUP_IMAGE_CHANGED 3
4580#define DC_INFO_MEMBER_ADDED_TO_GROUP 4
4581#define DC_INFO_MEMBER_REMOVED_FROM_GROUP 5
4582#define DC_INFO_AUTOCRYPT_SETUP_MESSAGE 6
4583#define DC_INFO_SECURE_JOIN_MESSAGE 7
4584#define DC_INFO_LOCATIONSTREAMING_ENABLED 8
4585#define DC_INFO_LOCATION_ONLY 9
4586#define DC_INFO_EPHEMERAL_TIMER_CHANGED 10
4587#define DC_INFO_PROTECTION_ENABLED 11
4588#define DC_INFO_PROTECTION_DISABLED 12
4589#define DC_INFO_INVALID_UNENCRYPTED_MAIL 13
4590#define DC_INFO_WEBXDC_INFO_MESSAGE 32
4591
4592
4609
4610
4626
4627
4643
4644
4659
4660
4680char* dc_msg_get_error (const dc_msg_t* msg);
4681
4682
4712
4713#define DC_VIDEOCHATTYPE_UNKNOWN 0
4714#define DC_VIDEOCHATTYPE_BASICWEBRTC 1
4715#define DC_VIDEOCHATTYPE_JITSI 2
4716
4717
4742
4743
4770
4771
4780void dc_msg_set_text (dc_msg_t* msg, const char* text);
4781
4782
4807void dc_msg_set_html (dc_msg_t* msg, const char* html);
4808
4809
4819void dc_msg_set_subject (dc_msg_t* msg, const char* subject);
4820
4821
4834void dc_msg_set_override_sender_name(dc_msg_t* msg, const char* name);
4835
4836
4859void dc_msg_set_file_and_deduplicate(dc_msg_t* msg, const char* file, const char* name, const char* filemime);
4860
4861
4872void dc_msg_set_dimension (dc_msg_t* msg, int width, int height);
4873
4874
4884void dc_msg_set_duration (dc_msg_t* msg, int duration);
4885
4886
4903void dc_msg_set_location (dc_msg_t* msg, double latitude, double longitude);
4904
4905
4927void dc_msg_latefiling_mediasize (dc_msg_t* msg, int width, int height, int duration);
4928
4929
4944void dc_msg_set_quote (dc_msg_t* msg, const dc_msg_t* quote);
4945
4946
4962
4963
4986
5002
5003
5017
5018
5030uint32_t dc_msg_get_saved_msg_id (const dc_msg_t* msg);
5031
5032
5042
5062
5063
5064#define DC_CONTACT_ID_SELF 1
5065#define DC_CONTACT_ID_INFO 2 // centered messages as "member added", used in all chats
5066#define DC_CONTACT_ID_DEVICE 5 // messages "update info" in the device-chat
5067#define DC_CONTACT_ID_LAST_SPECIAL 9
5068
5069
5078
5079
5087uint32_t dc_contact_get_id (const dc_contact_t* contact);
5088
5089
5098char* dc_contact_get_addr (const dc_contact_t* contact);
5099
5100
5115char* dc_contact_get_name (const dc_contact_t* contact);
5116
5117
5138
5139
5156
5157
5158// dc_contact_get_first_name is removed,
5159// the following define is to make upgrading more smoothly.
5160#define dc_contact_get_first_name dc_contact_get_display_name
5161
5162
5178
5179
5192
5193
5205uint32_t dc_contact_get_color (const dc_contact_t* contact);
5206
5207
5220
5230
5231
5245
5246
5257
5258
5277
5286
5287
5310
5311
5317
5318
5332dc_provider_t* dc_provider_new_from_email (const dc_context_t* context, const char* email);
5333
5334
5350
5351
5364
5365
5381
5382
5394
5395
5403
5404
5415
5416
5417#define DC_TEXT1_DRAFT 1
5418#define DC_TEXT1_USERNAME 2
5419#define DC_TEXT1_SELF 3
5420
5421
5432
5433
5443char* dc_lot_get_text1 (const dc_lot_t* lot);
5444
5445
5455char* dc_lot_get_text2 (const dc_lot_t* lot);
5456
5457
5468
5469
5478
5479
5487uint32_t dc_lot_get_id (const dc_lot_t* lot);
5488
5489
5499int64_t dc_lot_get_timestamp (const dc_lot_t* lot);
5500
5501
5524
5525
5531#define DC_MSG_TEXT 10
5532
5533
5545#define DC_MSG_IMAGE 20
5546
5547
5553#define DC_MSG_GIF 21
5554
5555
5563#define DC_MSG_STICKER 23
5564
5565
5571#define DC_MSG_AUDIO 40
5572
5573
5580#define DC_MSG_VOICE 41
5581
5582
5591#define DC_MSG_VIDEO 50
5592
5593
5599#define DC_MSG_FILE 60
5600
5601
5610#define DC_MSG_VIDEOCHAT_INVITATION 70
5611
5612
5618#define DC_MSG_WEBXDC 80
5619
5624#define DC_MSG_VCARD 90
5625
5629
5630
5641
5645#define DC_STATE_UNDEFINED 0
5646
5650#define DC_STATE_IN_FRESH 10
5651
5655#define DC_STATE_IN_NOTICED 13
5656
5660#define DC_STATE_IN_SEEN 16
5661
5667#define DC_STATE_OUT_PREPARING 18
5668
5672#define DC_STATE_OUT_DRAFT 19
5673
5677#define DC_STATE_OUT_PENDING 20
5678
5682#define DC_STATE_OUT_FAILED 24
5683
5688#define DC_STATE_OUT_DELIVERED 26
5689
5693#define DC_STATE_OUT_MDN_RCVD 28
5694
5698
5699
5710
5715#define DC_CHAT_TYPE_UNDEFINED 0
5716
5720#define DC_CHAT_TYPE_SINGLE 100
5721
5725#define DC_CHAT_TYPE_GROUP 120
5726
5730#define DC_CHAT_TYPE_MAILINGLIST 140
5731
5735#define DC_CHAT_TYPE_BROADCAST 160
5736
5740
5741
5752
5756#define DC_SOCKET_AUTO 0
5757
5758
5762#define DC_SOCKET_SSL 1
5763
5764
5768#define DC_SOCKET_STARTTLS 2
5769
5770
5774#define DC_SOCKET_PLAIN 3
5775
5779
5780
5792
5793
5799#define DC_LP_AUTH_OAUTH2 0x2
5800
5801
5806#define DC_LP_AUTH_NORMAL 0x4
5807
5808
5812
5813#define DC_LP_AUTH_FLAGS (DC_LP_AUTH_OAUTH2|DC_LP_AUTH_NORMAL) // if none of these flags are set, the default is chosen
5814
5826
5830#define DC_CERTCK_AUTO 0
5831
5836#define DC_CERTCK_STRICT 1
5837
5842#define DC_CERTCK_ACCEPT_INVALID 2
5843
5848#define DC_CERTCK_ACCEPT_INVALID_CERTIFICATES 3
5849
5853
5854
5860
5871
5880
5907void dc_jsonrpc_request(dc_jsonrpc_instance_t* jsonrpc_instance, const char* request);
5908
5919
5931char* dc_jsonrpc_blocking_call(dc_jsonrpc_instance_t* jsonrpc_instance, const char *input);
5932
5940
5953
5954// Alias for backwards compatibility, use dc_get_next_event instead.
5955#define dc_accounts_get_next_event dc_get_next_event
5956
5965
5966// Alias for backwards compatibility, use dc_event_emtitter_unref instead.
5967#define dc_accounts_event_emitter_unref dc_event_emitter_unref
5968
5975
5988
5989
6002
6003
6016
6017
6029
6030
6042
6043
6054
6055
6064
6065
6079
6088#define DC_EVENT_INFO 100
6089
6090
6097#define DC_EVENT_SMTP_CONNECTED 101
6098
6099
6106#define DC_EVENT_IMAP_CONNECTED 102
6107
6114#define DC_EVENT_SMTP_MESSAGE_SENT 103
6115
6122#define DC_EVENT_IMAP_MESSAGE_DELETED 104
6123
6130#define DC_EVENT_IMAP_MESSAGE_MOVED 105
6131
6138#define DC_EVENT_IMAP_INBOX_IDLE 106
6139
6146#define DC_EVENT_NEW_BLOB_FILE 150
6147
6154#define DC_EVENT_DELETED_BLOB_FILE 151
6155
6164#define DC_EVENT_WARNING 300
6165
6166
6184#define DC_EVENT_ERROR 400
6185
6186
6197#define DC_EVENT_ERROR_SELF_NOT_IN_GROUP 410
6198
6199
6210#define DC_EVENT_MSGS_CHANGED 2000
6211
6212
6219#define DC_EVENT_REACTIONS_CHANGED 2001
6220
6221
6234#define DC_EVENT_INCOMING_REACTION 2002
6235
6236
6237
6254#define DC_EVENT_INCOMING_WEBXDC_NOTIFY 2003
6255
6256
6269#define DC_EVENT_INCOMING_MSG 2005
6270
6282#define DC_EVENT_INCOMING_MSG_BUNCH 2006
6283
6284
6297#define DC_EVENT_MSGS_NOTICED 2008
6298
6299
6307#define DC_EVENT_MSG_DELIVERED 2010
6308
6309
6318#define DC_EVENT_MSG_FAILED 2012
6319
6320
6328#define DC_EVENT_MSG_READ 2015
6329
6330
6337#define DC_EVENT_MSG_DELETED 2016
6338
6339
6349#define DC_EVENT_CHAT_MODIFIED 2020
6350
6357#define DC_EVENT_CHAT_EPHEMERAL_TIMER_MODIFIED 2021
6358
6359
6369#define DC_EVENT_CHAT_DELETED 2023
6370
6371
6378#define DC_EVENT_CONTACTS_CHANGED 2030
6379
6380
6381
6390#define DC_EVENT_LOCATION_CHANGED 2035
6391
6392
6399#define DC_EVENT_CONFIGURE_PROGRESS 2041
6400
6401
6408#define DC_EVENT_IMEX_PROGRESS 2051
6409
6410
6421#define DC_EVENT_IMEX_FILE_WRITTEN 2052
6422
6423
6438#define DC_EVENT_SECUREJOIN_INVITER_PROGRESS 2060
6439
6440
6454#define DC_EVENT_SECUREJOIN_JOINER_PROGRESS 2061
6455
6456
6466#define DC_EVENT_CONNECTIVITY_CHANGED 2100
6467
6468
6473#define DC_EVENT_SELFAVATAR_CHANGED 2110
6474
6475
6485#define DC_EVENT_CONFIG_SYNCED 2111
6486
6487
6502#define DC_EVENT_WEBXDC_STATUS_UPDATE 2120
6503
6509
6510#define DC_EVENT_WEBXDC_INSTANCE_DELETED 2121
6511
6521
6522#define DC_EVENT_WEBXDC_REALTIME_DATA 2150
6523
6530
6531#define DC_EVENT_WEBXDC_REALTIME_ADVERTISEMENT 2151
6532
6541
6542#define DC_EVENT_ACCOUNTS_BACKGROUND_FETCH_DONE 2200
6543
6549
6550#define DC_EVENT_CHATLIST_CHANGED 2300
6551
6558
6559#define DC_EVENT_CHATLIST_ITEM_CHANGED 2301
6560
6566
6567#define DC_EVENT_ACCOUNTS_CHANGED 2302
6568
6578
6579#define DC_EVENT_ACCOUNTS_ITEM_CHANGED 2303
6580
6586#define DC_EVENT_CHANNEL_OVERFLOW 2400
6587
6591
6592
6593#define DC_EVENT_DATA1_IS_STRING(e) 0 // not used anymore
6594#define DC_EVENT_DATA2_IS_STRING(e) ((e)==DC_EVENT_CONFIGURE_PROGRESS || (e)==DC_EVENT_IMEX_FILE_WRITTEN || ((e)>=100 && (e)<=499))
6595
6596
6597/*
6598 * Values for dc_get|set_config("show_emails")
6599 */
6600#define DC_SHOW_EMAILS_OFF 0
6601#define DC_SHOW_EMAILS_ACCEPTED_CONTACTS 1
6602#define DC_SHOW_EMAILS_ALL 2
6603
6604
6605/*
6606 * Values for dc_get|set_config("media_quality")
6607 */
6608#define DC_MEDIA_QUALITY_BALANCED 0
6609#define DC_MEDIA_QUALITY_WORSE 1
6610
6611
6620
6633#define DC_PROVIDER_STATUS_OK 1
6634
6646#define DC_PROVIDER_STATUS_PREPARATION 2
6647
6660#define DC_PROVIDER_STATUS_BROKEN 3
6661
6665
6666
6677
6682#define DC_CHAT_VISIBILITY_NORMAL 0
6683
6696#define DC_CHAT_VISIBILITY_ARCHIVED 1
6697
6702#define DC_CHAT_VISIBILITY_PINNED 2
6703
6707
6708
6719
6723#define DC_DOWNLOAD_DONE 0
6724
6728#define DC_DOWNLOAD_AVAILABLE 10
6729
6733#define DC_DOWNLOAD_FAILURE 20
6734
6738#define DC_DOWNLOAD_UNDECIPHERABLE 30
6739
6743#define DC_DOWNLOAD_IN_PROGRESS 1000
6744
6745
6746
6750
6751
6770
6774#define DC_STR_NOMESSAGES 1
6775
6779#define DC_STR_SELF 2
6780
6784#define DC_STR_DRAFT 3
6785
6789#define DC_STR_VOICEMESSAGE 7
6790
6794#define DC_STR_IMAGE 9
6795
6799#define DC_STR_VIDEO 10
6800
6804#define DC_STR_AUDIO 11
6805
6809#define DC_STR_FILE 12
6810
6818#define DC_STR_MSGGRPNAME 15
6819
6825#define DC_STR_MSGGRPIMGCHANGED 16
6826
6833#define DC_STR_MSGADDMEMBER 17
6834
6841#define DC_STR_MSGDELMEMBER 18
6842
6848#define DC_STR_MSGGROUPLEFT 19
6849
6853#define DC_STR_GIF 23
6854
6858#define DC_STR_ENCRYPTEDMSG 24
6859
6863#define DC_STR_E2E_AVAILABLE 25
6864
6866#define DC_STR_ENCR_TRANSP 27
6867
6871#define DC_STR_ENCR_NONE 28
6872
6876#define DC_STR_CANTDECRYPT_MSG_BODY 29
6877
6881#define DC_STR_FINGERPRINTS 30
6882
6888#define DC_STR_READRCPT 31
6889
6896#define DC_STR_READRCPT_MAILBODY 32
6897
6899#define DC_STR_MSGGRPIMGDELETED 33
6900
6905#define DC_STR_E2E_PREFERRED 34
6906
6911#define DC_STR_CONTACT_VERIFIED 35
6912
6918#define DC_STR_CONTACT_NOT_VERIFIED 36
6919
6925#define DC_STR_CONTACT_SETUP_CHANGED 37
6926
6930#define DC_STR_ARCHIVEDCHATS 40
6931
6935#define DC_STR_AC_SETUP_MSG_SUBJECT 42
6936
6940#define DC_STR_AC_SETUP_MSG_BODY 43
6941
6946#define DC_STR_CANNOT_LOGIN 60
6947
6956#define DC_STR_MSGACTIONBYUSER 62
6957
6965#define DC_STR_MSGACTIONBYME 63
6966
6970#define DC_STR_MSGLOCATIONENABLED 64
6971
6975#define DC_STR_MSGLOCATIONDISABLED 65
6976
6980#define DC_STR_LOCATION 66
6981
6985#define DC_STR_STICKER 67
6986
6990#define DC_STR_DEVICE_MESSAGES 68
6991
6995#define DC_STR_SAVED_MESSAGES 69
6996
7000#define DC_STR_DEVICE_MESSAGES_HINT 70
7001
7005#define DC_STR_WELCOME_MESSAGE 71
7006
7010#define DC_STR_UNKNOWN_SENDER_FOR_CHAT 72
7011
7017#define DC_STR_SUBJECT_FOR_NEW_CONTACT 73
7018
7023#define DC_STR_FAILED_SENDING_TO 74
7024
7030#define DC_STR_EPHEMERAL_DISABLED 75
7031
7039#define DC_STR_EPHEMERAL_SECONDS 76
7040
7046#define DC_STR_EPHEMERAL_MINUTE 77
7047
7053#define DC_STR_EPHEMERAL_HOUR 78
7054
7060#define DC_STR_EPHEMERAL_DAY 79
7061
7067#define DC_STR_EPHEMERAL_WEEK 80
7068
7070#define DC_STR_EPHEMERAL_FOUR_WEEKS 81
7071
7075#define DC_STR_VIDEOCHAT_INVITATION 82
7076
7081#define DC_STR_VIDEOCHAT_INVITE_MSG_BODY 83
7082
7087#define DC_STR_CONFIGURATION_FAILED 84
7088
7093#define DC_STR_BAD_TIME_MSG_BODY 85
7094
7098#define DC_STR_UPDATE_REMINDER_MSG_BODY 86
7099
7103#define DC_STR_ERROR_NO_NETWORK 87
7104
7109#define DC_STR_REPLY_NOUN 90
7110
7114#define DC_STR_SELF_DELETED_MSG_BODY 91
7115
7119#define DC_STR_SERVER_TURNED_OFF 92
7120
7128#define DC_STR_EPHEMERAL_MINUTES 93
7129
7137#define DC_STR_EPHEMERAL_HOURS 94
7138
7146#define DC_STR_EPHEMERAL_DAYS 95
7147
7155#define DC_STR_EPHEMERAL_WEEKS 96
7156
7160#define DC_STR_FORWARDED 97
7161
7167#define DC_STR_QUOTA_EXCEEDING_MSG_BODY 98
7168
7176#define DC_STR_PARTIAL_DOWNLOAD_MSG_BODY 99
7177
7183#define DC_STR_DOWNLOAD_AVAILABILITY 100
7184
7188#define DC_STR_SYNC_MSG_SUBJECT 101
7189
7198#define DC_STR_SYNC_MSG_BODY 102
7199
7203#define DC_STR_INCOMING_MESSAGES 103
7204
7208#define DC_STR_OUTGOING_MESSAGES 104
7209
7215#define DC_STR_STORAGE_ON_DOMAIN 105
7216
7218#define DC_STR_ONE_MOMENT 106
7219
7223#define DC_STR_CONNECTED 107
7224
7228#define DC_STR_CONNTECTING 108
7229
7233#define DC_STR_UPDATING 109
7234
7238#define DC_STR_SENDING 110
7239
7243#define DC_STR_LAST_MSG_SENT_SUCCESSFULLY 111
7244
7250#define DC_STR_ERROR 112
7251
7255#define DC_STR_NOT_SUPPORTED_BY_PROVIDER 113
7256
7260#define DC_STR_MESSAGES 114
7261
7265#define DC_STR_BROADCAST_LIST 115
7266
7270#define DC_STR_PART_OF_TOTAL_USED 116
7271
7280#define DC_STR_SECURE_JOIN_STARTED 117
7281
7290#define DC_STR_SECURE_JOIN_REPLIES 118
7291
7297#define DC_STR_SETUP_CONTACT_QR_DESC 119
7298
7304#define DC_STR_SECURE_JOIN_GROUP_QR_DESC 120
7305
7309#define DC_STR_NOT_CONNECTED 121
7310
7315#define DC_STR_AEAP_ADDR_CHANGED 122
7316
7328#define DC_STR_AEAP_EXPLANATION_AND_LINK 123
7329
7334#define DC_STR_GROUP_NAME_CHANGED_BY_YOU 124
7335
7341#define DC_STR_GROUP_NAME_CHANGED_BY_OTHER 125
7342
7344#define DC_STR_GROUP_IMAGE_CHANGED_BY_YOU 126
7345
7349#define DC_STR_GROUP_IMAGE_CHANGED_BY_OTHER 127
7350
7356#define DC_STR_ADD_MEMBER_BY_YOU 128
7357
7364#define DC_STR_ADD_MEMBER_BY_OTHER 129
7365
7371#define DC_STR_REMOVE_MEMBER_BY_YOU 130
7372
7379#define DC_STR_REMOVE_MEMBER_BY_OTHER 131
7380
7384#define DC_STR_GROUP_LEFT_BY_YOU 132
7385
7391#define DC_STR_GROUP_LEFT_BY_OTHER 133
7392
7396#define DC_STR_GROUP_IMAGE_DELETED_BY_YOU 134
7397
7403#define DC_STR_GROUP_IMAGE_DELETED_BY_OTHER 135
7404
7408#define DC_STR_LOCATION_ENABLED_BY_YOU 136
7409
7415#define DC_STR_LOCATION_ENABLED_BY_OTHER 137
7416
7420#define DC_STR_EPHEMERAL_TIMER_DISABLED_BY_YOU 138
7421
7427#define DC_STR_EPHEMERAL_TIMER_DISABLED_BY_OTHER 139
7428
7434#define DC_STR_EPHEMERAL_TIMER_SECONDS_BY_YOU 140
7435
7442#define DC_STR_EPHEMERAL_TIMER_SECONDS_BY_OTHER 141
7443
7447#define DC_STR_EPHEMERAL_TIMER_1_MINUTE_BY_YOU 142
7448
7454#define DC_STR_EPHEMERAL_TIMER_1_MINUTE_BY_OTHER 143
7455
7459#define DC_STR_EPHEMERAL_TIMER_1_HOUR_BY_YOU 144
7460
7466#define DC_STR_EPHEMERAL_TIMER_1_HOUR_BY_OTHER 145
7467
7471#define DC_STR_EPHEMERAL_TIMER_1_DAY_BY_YOU 146
7472
7478#define DC_STR_EPHEMERAL_TIMER_1_DAY_BY_OTHER 147
7479
7483#define DC_STR_EPHEMERAL_TIMER_1_WEEK_BY_YOU 148
7484
7490#define DC_STR_EPHEMERAL_TIMER_1_WEEK_BY_OTHER 149
7491
7497#define DC_STR_EPHEMERAL_TIMER_MINUTES_BY_YOU 150
7498
7505#define DC_STR_EPHEMERAL_TIMER_MINUTES_BY_OTHER 151
7506
7512#define DC_STR_EPHEMERAL_TIMER_HOURS_BY_YOU 152
7513
7520#define DC_STR_EPHEMERAL_TIMER_HOURS_BY_OTHER 153
7521
7527#define DC_STR_EPHEMERAL_TIMER_DAYS_BY_YOU 154
7528
7535#define DC_STR_EPHEMERAL_TIMER_DAYS_BY_OTHER 155
7536
7542#define DC_STR_EPHEMERAL_TIMER_WEEKS_BY_YOU 156
7543
7550#define DC_STR_EPHEMERAL_TIMER_WEEKS_BY_OTHER 157
7551
7555#define DC_STR_BACKUP_TRANSFER_QR 162
7556
7560#define DC_STR_BACKUP_TRANSFER_MSG_BODY 163
7561
7565#define DC_STR_CHAT_PROTECTION_ENABLED 170
7566
7570#define DC_STR_CHAT_PROTECTION_DISABLED 171
7571
7575#define DC_STR_NEW_GROUP_SEND_FIRST_MESSAGE 172
7576
7582#define DC_STR_MESSAGE_ADD_MEMBER 173
7583
7589#define DC_STR_INVALID_UNENCRYPTED_MAIL 174
7590
7597#define DC_STR_YOU_REACTED 176
7598
7606#define DC_STR_REACTED_BY 177
7607
7611#define DC_STR_SECUREJOIN_WAIT 190
7612
7616#define DC_STR_SECUREJOIN_WAIT_TIMEOUT 191
7617
7622#define DC_STR_SECUREJOIN_TAKES_LONGER 192
7623
7625#define DC_STR_CONTACT 200
7626
7630
7631
7632#ifdef PY_CFFI_INC
7633/* Helper utility to locate the header file when building python bindings. */
7634char* _dc_header_file_location(void) {
7635 return __FILE__;
7636}
7637#endif
7638
7639
7640#ifdef __cplusplus
7641}
7642#endif
7643#endif // __DELTACHAT_H__
This class provides functionality that can be used to manage several dc_context_t objects running at ...
int dc_accounts_select_account(dc_accounts_t *accounts, uint32_t account_id)
Change the selected account.
void dc_accounts_unref(dc_accounts_t *accounts)
Free an account manager object.
dc_event_emitter_t * dc_accounts_get_event_emitter(dc_accounts_t *accounts)
Create the event emitter that is used to receive events.
dc_context_t * dc_accounts_get_selected_account(dc_accounts_t *accounts)
Get the currently selected account.
void dc_accounts_maybe_network(dc_accounts_t *accounts)
This function should be called when there is a hint that the network is available again.
uint32_t dc_accounts_migrate_account(dc_accounts_t *accounts, const char *dbfile)
Migrate independent accounts into accounts managed by the account manager.
int dc_accounts_background_fetch(dc_accounts_t *accounts, uint64_t timeout)
Perform a background fetch for all accounts in parallel with a timeout.
dc_context_t * dc_accounts_get_account(dc_accounts_t *accounts, uint32_t account_id)
Get an account context from an account ID.
dc_array_t * dc_accounts_get_all(dc_accounts_t *accounts)
List all accounts.
dc_jsonrpc_instance_t * dc_jsonrpc_init(dc_accounts_t *account_manager)
Create the jsonrpc instance that is used to call the jsonrpc.
void dc_accounts_set_push_device_token(dc_accounts_t *accounts, const char *token)
Sets device token for Apple Push Notification service.
void dc_accounts_start_io(dc_accounts_t *accounts)
Start job and IMAP/SMTP tasks for all accounts managed by the account manager.
void dc_accounts_stop_io(dc_accounts_t *accounts)
Stop job and IMAP/SMTP tasks for all accounts and return when they are finished.
void dc_accounts_maybe_network_lost(dc_accounts_t *accounts)
This function can be called when there is a hint that the network is lost.
uint32_t dc_accounts_add_account(dc_accounts_t *accounts)
Add a new account to the account manager.
dc_accounts_t * dc_accounts_new(const char *dir, int writable)
Create a new account manager.
uint32_t dc_accounts_add_closed_account(dc_accounts_t *accounts)
Add a new closed account to the account manager.
int dc_accounts_remove_account(dc_accounts_t *accounts, uint32_t account_id)
Remove an account from the account manager.
An object containing a simple array.
void dc_array_unref(dc_array_t *array)
Free an array object.
double dc_array_get_accuracy(const dc_array_t *array, size_t index)
Return the accuracy of the item at the given index.
int64_t dc_array_get_timestamp(const dc_array_t *array, size_t index)
Return the timestamp of the item at the given index.
uint32_t dc_array_get_chat_id(const dc_array_t *array, size_t index)
Return the chat ID of the item at the given index.
int dc_array_is_independent(const dc_array_t *array, size_t index)
Return the independent-state of the location at the given index.
uint32_t dc_array_get_msg_id(const dc_array_t *array, size_t index)
Return the message ID of the item at the given index.
uint32_t dc_array_get_contact_id(const dc_array_t *array, size_t index)
Return the contact ID of the item at the given index.
double dc_array_get_longitude(const dc_array_t *array, size_t index)
Return the longitude of the item at the given index.
size_t dc_array_get_cnt(const dc_array_t *array)
Find out the number of items in an array.
uint32_t dc_array_get_id(const dc_array_t *array, size_t index)
Get the item at the given index as an ID.
char * dc_array_get_marker(const dc_array_t *array, size_t index)
Return the marker-character of the item at the given index.
double dc_array_get_latitude(const dc_array_t *array, size_t index)
Return the latitude of the item at the given index.
Set up another device.
char * dc_backup_provider_get_qr(const dc_backup_provider_t *backup_provider)
Returns the QR code text that will offer the backup to other devices.
void dc_backup_provider_unref(dc_backup_provider_t *backup_provider)
Frees a dc_backup_provider_t object.
void dc_backup_provider_wait(dc_backup_provider_t *backup_provider)
Waits for the sending to finish.
char * dc_backup_provider_get_qr_svg(const dc_backup_provider_t *backup_provider)
Returns the QR code SVG image that will offer the backup to other devices.
dc_backup_provider_t * dc_backup_provider_new(dc_context_t *context)
Creates an object for sending a backup to another device.
An object representing a single chat in memory.
char * dc_chat_get_name(const dc_chat_t *chat)
Get name of a chat.
int dc_chat_is_sending_locations(const dc_chat_t *chat)
Check if locations are sent to the chat at the time the object was created using dc_get_chat().
int dc_chat_get_type(const dc_chat_t *chat)
Get chat type as one of the DC_CHAT_TYPE constants:
int dc_chat_is_protection_broken(const dc_chat_t *chat)
Checks if the chat was protected, and then an incoming message broke this protection.
char * dc_chat_get_mailinglist_addr(const dc_chat_t *chat)
Returns the address where messages are sent to if the chat is a mailing list.
uint32_t dc_chat_get_id(const dc_chat_t *chat)
Get the chat ID.
int dc_chat_is_device_talk(const dc_chat_t *chat)
Check if a chat is a device-talk.
int64_t dc_chat_get_remaining_mute_duration(const dc_chat_t *chat)
Get the exact state of the mute of a chat.
int dc_chat_is_contact_request(const dc_chat_t *chat)
Check if a chat is a contact request chat.
int dc_chat_get_visibility(const dc_chat_t *chat)
Get visibility of chat.
void dc_chat_unref(dc_chat_t *chat)
Free a chat object.
int dc_chat_is_unpromoted(const dc_chat_t *chat)
Check if a group chat is still unpromoted.
uint32_t dc_chat_get_color(const dc_chat_t *chat)
Get a color for the chat.
int dc_chat_can_send(const dc_chat_t *chat)
Check if messages can be sent to a given chat.
int dc_chat_is_self_talk(const dc_chat_t *chat)
Check if a chat is a self talk.
char * dc_chat_get_profile_image(const dc_chat_t *chat)
Get the chat's profile image.
int dc_chat_is_protected(const dc_chat_t *chat)
Check if a chat is protected.
int dc_chat_is_muted(const dc_chat_t *chat)
Check whether the chat is currently muted (can be changed by dc_set_chat_mute_duration()).
int dc_chat_is_encrypted(const dc_chat_t *chat)
Check if the chat is encrypted.
An object representing a single chatlist in memory.
uint32_t dc_chatlist_get_msg_id(const dc_chatlist_t *chatlist, size_t index)
Get a single message ID of a chatlist.
void dc_chatlist_unref(dc_chatlist_t *chatlist)
Free a chatlist object.
dc_lot_t * dc_chatlist_get_summary(const dc_chatlist_t *chatlist, size_t index, dc_chat_t *chat)
Get a summary for a chatlist index.
dc_context_t * dc_chatlist_get_context(dc_chatlist_t *chatlist)
Helper function to get the associated context object.
uint32_t dc_chatlist_get_chat_id(const dc_chatlist_t *chatlist, size_t index)
Get a single chat ID of a chatlist.
size_t dc_chatlist_get_cnt(const dc_chatlist_t *chatlist)
Find out the number of chats in a chatlist.
An object representing a single contact in memory.
char * dc_contact_get_addr(const dc_contact_t *contact)
Get the e-mail address of a contact.
char * dc_contact_get_name_n_addr(const dc_contact_t *contact)
Get a summary of name and address.
int dc_contact_is_verified(dc_contact_t *contact)
Check if the contact can be added to verified chats, i.e.
char * dc_contact_get_profile_image(const dc_contact_t *contact)
Get the contact's profile image.
void dc_contact_unref(dc_contact_t *contact)
Free a contact object.
char * dc_contact_get_auth_name(const dc_contact_t *contact)
Get original contact name.
int64_t dc_contact_get_last_seen(const dc_contact_t *contact)
Get the contact's last seen timestamp.
uint32_t dc_contact_get_verifier_id(dc_contact_t *contact)
Return the contact ID that verified a contact.
char * dc_contact_get_status(const dc_contact_t *contact)
Get the contact's status.
int dc_contact_is_blocked(const dc_contact_t *contact)
Check if a contact is blocked.
char * dc_contact_get_name(const dc_contact_t *contact)
Get the edited contact name.
char * dc_contact_get_display_name(const dc_contact_t *contact)
Get display name.
uint32_t dc_contact_get_color(const dc_contact_t *contact)
Get a color for the contact.
uint32_t dc_contact_get_id(const dc_contact_t *contact)
Get the ID of a contact.
int dc_contact_is_bot(dc_contact_t *contact)
Returns whether contact is a bot.
int dc_contact_was_seen_recently(const dc_contact_t *contact)
Check if the contact was seen recently.
An object representing a single account.
char * dc_imex_has_backup(dc_context_t *context, const char *dir)
Check if there is a backup file.
int dc_add_address_book(dc_context_t *context, const char *addr_book)
Add a number of contacts.
int dc_get_msg_cnt(dc_context_t *context, uint32_t chat_id)
Get the total number of messages in a chat.
dc_context_t * dc_context_new_closed(const char *dbfile)
Create a new context object.
char * dc_make_vcard(dc_context_t *context, uint32_t contact_id)
Make a vCard.
dc_array_t * dc_get_contacts(dc_context_t *context, uint32_t flags, const char *query)
Returns known and unblocked contacts.
void dc_set_draft(dc_context_t *context, uint32_t chat_id, dc_msg_t *msg)
Save a draft for a chat in the database.
uint32_t dc_add_device_msg(dc_context_t *context, const char *label, dc_msg_t *msg)
Add a message to the device-chat.
void dc_send_delete_request(dc_context_t *context, const uint32_t *msg_ids, int msg_cnt)
Send chat members a request to delete the given messages.
dc_chatlist_t * dc_get_chatlist(dc_context_t *context, int flags, const char *query_str, uint32_t query_id)
Get a list of chats.
dc_array_t * dc_get_next_msgs(dc_context_t *context)
Returns the message IDs of all messages of any chat with a database ID higher than last_msg_id config...
uint32_t dc_init_webxdc_integration(dc_context_t *context, uint32_t chat_id)
Init a Webxdc integration.
char * dc_get_contact_encrinfo(dc_context_t *context, uint32_t contact_id)
Get encryption info for a contact.
uint32_t dc_lookup_contact_id_by_addr(dc_context_t *context, const char *addr)
Check if an e-mail address belongs to a known and unblocked contact.
int dc_set_chat_profile_image(dc_context_t *context, uint32_t chat_id, const char *image)
Set group profile image.
uint32_t dc_send_text_msg(dc_context_t *context, uint32_t chat_id, const char *text_to_send)
Send a simple text message a given chat.
void dc_maybe_network(dc_context_t *context)
This function should be called when there is a hint that the network is available again,...
int dc_was_device_msg_ever_added(dc_context_t *context, const char *label)
Check if a device-message with a given label was ever added.
uint32_t dc_get_chat_ephemeral_timer(dc_context_t *context, uint32_t chat_id)
Get the chat's ephemeral message timer.
dc_array_t * dc_get_chat_media(dc_context_t *context, uint32_t chat_id, int msg_type, int msg_type2, int msg_type3)
Returns all message IDs of the given types in a given chat or any chat.
dc_lot_t * dc_check_qr(dc_context_t *context, const char *qr)
Check a scanned QR code.
dc_array_t * dc_get_locations(dc_context_t *context, uint32_t chat_id, uint32_t contact_id, int64_t timestamp_begin, int64_t timestamp_end)
Get shared locations from the database.
void dc_send_locations_to_chat(dc_context_t *context, uint32_t chat_id, int seconds)
Enable or disable location streaming for a chat.
dc_contact_t * dc_get_contact(dc_context_t *context, uint32_t contact_id)
Get a single contact object.
void dc_stop_io(dc_context_t *context)
Stop job, IMAP, SMTP and other tasks and return when they are finished.
dc_msg_t * dc_get_draft(dc_context_t *context, uint32_t chat_id)
Get draft for a chat, if any.
int dc_preconfigure_keypair(dc_context_t *context, const char *secret_data)
Save a keypair as the default keys for the user.
char * dc_create_qr_svg(const char *payload)
Create a QR code from any input data.
char * dc_get_blobdir(const dc_context_t *context)
Get the blob directory.
dc_array_t * dc_get_blocked_contacts(dc_context_t *context)
Get blocked contacts.
void dc_context_unref(dc_context_t *context)
Free a context object.
void dc_stop_ongoing_process(dc_context_t *context)
Signal an ongoing process to stop.
dc_msg_t * dc_get_msg(dc_context_t *context, uint32_t msg_id)
Get a single message object of the type dc_msg_t.
dc_array_t * dc_get_chat_msgs(dc_context_t *context, uint32_t chat_id, uint32_t flags, uint32_t marker1before)
Get all message IDs belonging to a chat.
char * dc_get_info(const dc_context_t *context)
Get information about the context.
int dc_receive_backup(dc_context_t *context, const char *qr)
Gets a backup offered by a dc_backup_provider_t object on another device.
int dc_is_sending_locations_to_chat(dc_context_t *context, uint32_t chat_id)
Check if location streaming is enabled.
void dc_block_chat(dc_context_t *context, uint32_t chat_id)
Block a chat.
char * dc_get_securejoin_qr(dc_context_t *context, uint32_t chat_id)
Get QR code text that will offer an Setup-Contact or Verified-Group invitation.
int dc_continue_key_transfer(dc_context_t *context, uint32_t msg_id, const char *setup_code)
Continue the Autocrypt Key Transfer on another device.
dc_array_t * dc_get_fresh_msgs(dc_context_t *context)
Returns the message IDs of all fresh messages of any chat.
int dc_set_stock_translation(dc_context_t *context, uint32_t stock_id, const char *stock_msg)
Set stock string translation.
void dc_set_webxdc_integration(dc_context_t *context, const char *file)
Set Webxdc file as integration.
int dc_set_chat_mute_duration(dc_context_t *context, uint32_t chat_id, int64_t duration)
Set mute duration of a chat.
dc_array_t * dc_wait_next_msgs(dc_context_t *context)
Waits for notification of new messages and returns an array of new message IDs.
int dc_get_fresh_msg_cnt(dc_context_t *context, uint32_t chat_id)
Get the number of fresh messages in a chat.
int dc_set_chat_name(dc_context_t *context, uint32_t chat_id, const char *name)
Set group name.
uint32_t dc_create_broadcast_list(dc_context_t *context)
Create a new broadcast list.
void dc_marknoticed_chat(dc_context_t *context, uint32_t chat_id)
Mark all messages in a chat as noticed.
int dc_set_chat_ephemeral_timer(dc_context_t *context, uint32_t chat_id, uint32_t timer)
Set the chat's ephemeral message timer.
int dc_remove_contact_from_chat(dc_context_t *context, uint32_t chat_id, uint32_t contact_id)
Remove a member from a group.
dc_array_t * dc_search_msgs(dc_context_t *context, uint32_t chat_id, const char *query)
Search messages containing the given query string.
int dc_may_be_valid_addr(const char *addr)
Rough check if a string may be a valid e-mail address.
int dc_is_configured(const dc_context_t *context)
Check if the context is already configured.
int dc_estimate_deletion_cnt(dc_context_t *context, int from_server, int64_t seconds)
Estimate the number of messages that will be deleted by the dc_set_config()-options delete_device_aft...
int dc_get_connectivity(dc_context_t *context)
Get the current connectivity, i.e.
char * dc_get_last_error(dc_context_t *context)
Get last error string.
char * dc_get_oauth2_url(dc_context_t *context, const char *addr, const char *redirect_uri)
Get URL that can be used to initiate an OAuth2 authorization.
uint32_t dc_get_chat_id_by_contact_id(dc_context_t *context, uint32_t contact_id)
Check, if there is a normal chat with a given contact.
char * dc_get_config(dc_context_t *context, const char *key)
Get a configuration option.
int dc_set_location(dc_context_t *context, double latitude, double longitude, double accuracy)
Set current location.
void dc_set_chat_visibility(dc_context_t *context, uint32_t chat_id, int visibility)
Set chat visibility to pinned, archived or normal.
int dc_get_push_state(dc_context_t *context)
Get the current push notification state.
int dc_add_contact_to_chat(dc_context_t *context, uint32_t chat_id, uint32_t contact_id)
Add a member to a group.
char * dc_get_msg_info(dc_context_t *context, uint32_t msg_id)
Get an informational text for a single message.
char * dc_get_connectivity_html(dc_context_t *context)
Get an overview of the current connectivity, and possibly more statistics.
dc_array_t * dc_get_chat_contacts(dc_context_t *context, uint32_t chat_id)
Get the contact IDs belonging to a chat.
dc_chat_t * dc_get_chat(dc_context_t *context, uint32_t chat_id)
Get a chat object by a chat ID.
uint32_t dc_get_id(dc_context_t *context)
Get the ID of a context object.
dc_context_t * dc_context_new(const char *os_name, const char *dbfile, const char *blobdir)
Create a new context object and try to open it without passphrase.
uint32_t dc_send_videochat_invitation(dc_context_t *context, uint32_t chat_id)
Send invitation to a videochat.
uint32_t dc_send_msg_sync(dc_context_t *context, uint32_t chat_id, dc_msg_t *msg)
Send a message defined by a dc_msg_t object to a chat, synchronously.
uint32_t dc_create_contact(dc_context_t *context, const char *name, const char *addr)
Add a single contact as a result of an explicit user action.
uint32_t dc_send_msg(dc_context_t *context, uint32_t chat_id, dc_msg_t *msg)
Send a message defined by a dc_msg_t object to a chat.
void dc_download_full_msg(dc_context_t *context, int msg_id)
Asks the core to start downloading a message fully.
char * dc_get_msg_html(dc_context_t *context, uint32_t msg_id)
Get uncut message, if available.
dc_event_emitter_t * dc_get_event_emitter(dc_context_t *context)
Create the event emitter that is used to receive events.
void dc_start_io(dc_context_t *context)
Start job and IMAP/SMTP tasks.
void dc_imex(dc_context_t *context, int what, const char *param1, const char *param2)
Import/export things.
char * dc_get_securejoin_qr_svg(dc_context_t *context, uint32_t chat_id)
Get QR code image from the QR code text generated by dc_get_securejoin_qr().
dc_array_t * dc_import_vcard(dc_context_t *context, const char *vcard)
Import a vCard.
char * dc_get_webxdc_status_updates(dc_context_t *context, uint32_t msg_id, uint32_t serial)
Get webxdc status updates.
dc_lot_t * dc_chatlist_get_summary2(dc_context_t *context, uint32_t chat_id, uint32_t msg_id)
Create a chatlist summary item when the chatlist object is already unref()'d.
uint32_t dc_create_chat_by_contact_id(dc_context_t *context, uint32_t contact_id)
Create a normal chat with a single user.
void dc_forward_msgs(dc_context_t *context, const uint32_t *msg_ids, int msg_cnt, uint32_t chat_id)
Forward messages to another chat.
int dc_send_webxdc_status_update(dc_context_t *context, uint32_t msg_id, const char *json, const char *descr)
A webxdc instance sends a status update to its other members.
dc_chatlist_t * dc_get_similar_chatlist(dc_context_t *context, uint32_t chat_id)
Returns a list of similar chats.
void dc_save_msgs(dc_context_t *context, const uint32_t *msg_ids, int msg_cnt)
Save a copy of messages in "Saved Messages".
int dc_set_config_from_qr(dc_context_t *context, const char *qr)
Set configuration values from a QR code.
void dc_str_unref(char *str)
Release a string returned by another deltachat-core function.
void dc_send_edit_request(dc_context_t *context, uint32_t msg_id, const char *new_text)
Send chat members a request to edit the given message's text.
int dc_delete_contact(dc_context_t *context, uint32_t contact_id)
Delete a contact so that it disappears from the corresponding lists.
void dc_delete_chat(dc_context_t *context, uint32_t chat_id)
Delete a chat.
void dc_block_contact(dc_context_t *context, uint32_t contact_id, int block)
Block or unblock a contact.
int dc_resend_msgs(dc_context_t *context, const uint32_t *msg_ids, int msg_cnt)
Resend messages and make information available for newly added chat members.
void dc_delete_msgs(dc_context_t *context, const uint32_t *msg_ids, int msg_cnt)
Delete messages.
void dc_configure(dc_context_t *context)
Configure a context.
uint32_t dc_join_securejoin(dc_context_t *context, const char *qr)
Continue a Setup-Contact or Verified-Group-Invite protocol started on another device with dc_get_secu...
void dc_markseen_msgs(dc_context_t *context, const uint32_t *msg_ids, int msg_cnt)
Mark messages as presented to the user.
uint32_t dc_create_group_chat(dc_context_t *context, int protect, const char *name)
Create a new group chat.
void dc_delete_all_locations(dc_context_t *context)
Delete all locations on the current device.
int dc_is_contact_in_chat(dc_context_t *context, uint32_t chat_id, uint32_t contact_id)
Check if a given contact ID is a member of a group chat.
int dc_context_is_open(dc_context_t *context)
Returns 1 if database is open.
void dc_accept_chat(dc_context_t *context, uint32_t chat_id)
Accept a contact request chat.
int dc_context_open(dc_context_t *context, const char *passphrase)
Opens the database with the given passphrase.
char * dc_initiate_key_transfer(dc_context_t *context)
Initiate Autocrypt Setup Transfer.
int dc_get_blocked_cnt(dc_context_t *context)
Get the number of blocked contacts.
int dc_context_change_passphrase(dc_context_t *context, const char *passphrase)
Changes the passphrase on the open database.
char * dc_get_chat_encrinfo(dc_context_t *context, uint32_t chat_id)
Get encryption info for a chat.
int dc_set_config(dc_context_t *context, const char *key, const char *value)
Configure the context.
Opaque object that is used to get events from a single context.
void dc_event_emitter_unref(dc_event_emitter_t *emitter)
Free a context event emitter object.
dc_event_t * dc_get_next_event(dc_event_emitter_t *emitter)
Get the next event from a context event emitter object.
Opaque object describing a single event.
void dc_event_unref(dc_event_t *event)
Free memory used by an event object.
int dc_event_get_data2_int(dc_event_t *event)
Get data associated with an event object.
char * dc_event_get_data1_str(dc_event_t *event)
Get data associated with an event object.
char * dc_event_get_data2_str(dc_event_t *event)
Get data associated with an event object.
uint32_t dc_event_get_account_id(dc_event_t *event)
Get the account ID this event belongs to.
int dc_event_get_id(dc_event_t *event)
Get the event ID from an event object.
int dc_event_get_data1_int(dc_event_t *event)
Get data associated with an event object.
Opaque object for using the json rpc api from the cffi bindings.
char * dc_jsonrpc_next_response(dc_jsonrpc_instance_t *jsonrpc_instance)
Get the next json_rpc response, blocks until there is a new event, so call this in a loop from a thre...
void dc_jsonrpc_unref(dc_jsonrpc_instance_t *jsonrpc_instance)
Free a jsonrpc instance.
char * dc_jsonrpc_blocking_call(dc_jsonrpc_instance_t *jsonrpc_instance, const char *input)
Make a JSON-RPC call and return a response.
void dc_jsonrpc_request(dc_jsonrpc_instance_t *jsonrpc_instance, const char *request)
Makes an asynchronous jsonrpc request, returns immediately and once the result is ready it can be ret...
An object containing a set of values.
int64_t dc_lot_get_timestamp(const dc_lot_t *lot)
Get the associated timestamp.
int dc_lot_get_state(const dc_lot_t *lot)
Get the associated state.
uint32_t dc_lot_get_id(const dc_lot_t *lot)
Get the associated ID.
int dc_lot_get_text1_meaning(const dc_lot_t *lot)
Get the meaning of the first string.
void dc_lot_unref(dc_lot_t *lot)
Frees an object containing a set of parameters.
char * dc_lot_get_text1(const dc_lot_t *lot)
Get first string.
char * dc_lot_get_text2(const dc_lot_t *lot)
Get second string.
An object representing a single message in memory.
void dc_msg_set_html(dc_msg_t *msg, const char *html)
Set the HTML part of a message object.
char * dc_msg_get_webxdc_blob(const dc_msg_t *msg, const char *filename, size_t *ret_bytes)
Return a file from inside a webxdc message.
uint32_t dc_msg_get_ephemeral_timer(const dc_msg_t *msg)
Get the ephemeral timer duration for a message.
char * dc_msg_get_filename(const dc_msg_t *msg)
Get an original attachment filename, with extension but without the path.
void dc_msg_set_override_sender_name(dc_msg_t *msg, const char *name)
Set different sender name for a message.
char * dc_msg_get_summarytext(const dc_msg_t *msg, int approx_characters)
Get a message summary as a single line of text.
int dc_msg_get_showpadlock(const dc_msg_t *msg)
Check if a padlock should be shown beside the message.
dc_lot_t * dc_msg_get_summary(const dc_msg_t *msg, const dc_chat_t *chat)
Get a summary for a message.
uint32_t dc_msg_get_chat_id(const dc_msg_t *msg)
Get the ID of the chat the message belongs to.
void dc_msg_set_quote(dc_msg_t *msg, const dc_msg_t *quote)
Set the message replying to.
int dc_msg_has_location(const dc_msg_t *msg)
Check if a message has a POI location bound to it.
char * dc_msg_get_text(const dc_msg_t *msg)
Get the text of the message.
uint32_t dc_msg_get_from_id(const dc_msg_t *msg)
Get the ID of the contact who wrote the message.
int64_t dc_msg_get_ephemeral_timestamp(const dc_msg_t *msg)
Get the timestamp of the ephemeral message removal.
int dc_msg_get_download_state(const dc_msg_t *msg)
Check if the message is completely downloaded or if some further action is needed.
void dc_msg_set_duration(dc_msg_t *msg, int duration)
Set the duration associated with message object.
void dc_msg_set_file_and_deduplicate(dc_msg_t *msg, const char *file, const char *name, const char *filemime)
Sets the file associated with a message.
int dc_msg_save_file(const dc_msg_t *msg, const char *path)
Save file copy at the user-provided path.
void dc_msg_set_text(dc_msg_t *msg, const char *text)
Set the text of a message object.
int64_t dc_msg_get_timestamp(const dc_msg_t *msg)
Get the message sending time.
uint32_t dc_msg_get_original_msg_id(const dc_msg_t *msg)
Get original message ID for a saved message from the "Saved Messages" chat.
char * dc_msg_get_quoted_text(const dc_msg_t *msg)
Get quoted text, if any.
char * dc_msg_get_override_sender_name(const dc_msg_t *msg)
Get the name that should be shown over the message (in a group chat) instead of the contact display n...
char * dc_msg_get_videochat_url(const dc_msg_t *msg)
Get URL of a videochat invitation.
void dc_msg_set_subject(dc_msg_t *msg, const char *subject)
Sets the email's subject.
int dc_msg_get_width(const dc_msg_t *msg)
Get the width of an image or a video.
char * dc_msg_get_filemime(const dc_msg_t *msg)
Get the MIME type of a file.
void dc_msg_unref(dc_msg_t *msg)
Free a message object.
char * dc_msg_get_webxdc_href(const dc_msg_t *msg)
Get link attached to an webxdc info message.
int dc_msg_is_bot(const dc_msg_t *msg)
Check if an incoming message is a bot message, i.e.
char * dc_msg_get_setupcodebegin(const dc_msg_t *msg)
Get the first characters of the setup code.
void dc_msg_set_dimension(dc_msg_t *msg, int width, int height)
Set the dimensions associated with message object.
int dc_msg_is_forwarded(const dc_msg_t *msg)
Check if the message is a forwarded message.
int dc_msg_has_deviating_timestamp(const dc_msg_t *msg)
Check if a message has a deviating timestamp.
int dc_msg_is_info(const dc_msg_t *msg)
Check if the message is an informational message, created by the device or by another users.
void dc_msg_latefiling_mediasize(dc_msg_t *msg, int width, int height, int duration)
Late filing information to a message.
int dc_msg_is_edited(const dc_msg_t *msg)
Check if the message was edited.
int dc_msg_get_state(const dc_msg_t *msg)
Get the state of a message.
void dc_msg_set_location(dc_msg_t *msg, double latitude, double longitude)
Set any location that should be bound to the message object.
int dc_msg_is_setupmessage(const dc_msg_t *msg)
Check if the message is an Autocrypt Setup Message.
uint64_t dc_msg_get_filebytes(const dc_msg_t *msg)
Get the size of the file.
char * dc_msg_get_subject(const dc_msg_t *msg)
Get the subject of the e-mail.
dc_msg_t * dc_msg_get_quoted_msg(const dc_msg_t *msg)
Get quoted message, if available.
uint32_t dc_msg_get_info_contact_id(const dc_msg_t *msg)
Return the contact ID of the profile to open when tapping the info message.
dc_msg_t * dc_msg_get_parent(const dc_msg_t *msg)
Get parent message, if available.
dc_msg_t * dc_msg_new(dc_context_t *context, int viewtype)
Create new message object.
void dc_msg_force_plaintext(dc_msg_t *msg)
Force the message to be sent in plain text.
int dc_msg_has_html(dc_msg_t *msg)
Checks if the message has a full HTML version.
int dc_msg_get_duration(const dc_msg_t *msg)
Get the duration of audio or video.
uint32_t dc_msg_get_id(const dc_msg_t *msg)
Get the ID of the message.
uint32_t dc_msg_get_saved_msg_id(const dc_msg_t *msg)
Check if a message was saved and return its ID inside "Saved Messages".
int dc_msg_get_info_type(const dc_msg_t *msg)
Get the type of an informational message.
int dc_msg_get_viewtype(const dc_msg_t *msg)
Get the type of the message.
int64_t dc_msg_get_sort_timestamp(const dc_msg_t *msg)
Get the message time used for sorting.
int dc_msg_get_videochat_type(const dc_msg_t *msg)
Get type of videochat.
int dc_msg_get_height(const dc_msg_t *msg)
Get the height of an image or a video.
char * dc_msg_get_error(const dc_msg_t *msg)
Gets the error status of the message.
int dc_msg_is_sent(const dc_msg_t *msg)
Check if a message was sent successfully.
char * dc_msg_get_file(const dc_msg_t *msg)
Find out full path of the file associated with a message.
int64_t dc_msg_get_received_timestamp(const dc_msg_t *msg)
Get the message receive time.
char * dc_msg_get_webxdc_info(const dc_msg_t *msg)
Get info from a webxdc message, in JSON format.
Opaque object containing information about one single e-mail provider.
int dc_provider_get_status(const dc_provider_t *provider)
Whether DC works with this provider.
char * dc_provider_get_before_login_hint(const dc_provider_t *provider)
Get hints to be shown to the user on the login screen.
char * dc_provider_get_overview_page(const dc_provider_t *provider)
URL of the overview page.
dc_provider_t * dc_provider_new_from_email_with_dns(const dc_context_t *context, const char *email)
Create a provider struct for the given e-mail address by local and DNS lookup.
dc_provider_t * dc_provider_new_from_email(const dc_context_t *context, const char *email)
Create a provider struct for the given e-mail address by local lookup.
void dc_provider_unref(dc_provider_t *provider)
Free the provider info struct.