loops_api

Description:

loops api

Loops API Flutter Package #
A Flutter package for interacting with the Loops API. The Loops API allows you to manage contacts, send events, and perform various operations related to customer engagement.
Features #


Create Contacts: Easily create new contacts with customizable properties such as email, first name, last name, and more.


Update Contacts: Update existing contact details, including first name, last name, subscription status, and custom fields.


Find Contacts: Retrieve contact information by email address. The package takes care of URL encoding for you.


Delete Contacts: Delete contacts by providing either their email address or userId.


Send Events: Send custom events associated with a contact, providing flexibility for tracking user interactions.


Send Transactional Emails: Seamlessly send transactional emails using the Loops API.


List Custom Fields: Retrieve a list of custom field objects, including key and label attributes.


Getting Started #


Authentication: Obtain your Loops API Key from Loops Dashboard.


Installation: Add the package to your pubspec.yaml file:
dependencies:
loops_api_flutter: ^0.0.4

Usage: Initialize the LoopsAPI class with your API key and start making API requests.
copied to clipboard


Use the API: Set the API Key in your Main method and then use the API Calls you would like:

import 'package:loops_api_flutter/loops_api_flutter.dart';
void main() {
// Initialize the LoopsAPI instance with your API key
loopsAPIKey = LoopsAPI(apiKey: 'Your-API-Key-here');

// Example: Create a new contact
loopsAPI.createContact(
email: '[email protected]',
firstName: 'John',
lastName: 'Doe',
subscribed: true,
userGroup: 'BetaUsers',
userId: '12345',
);

// Example: Update an existing contact
loopsAPI.updateContact(
email: '[email protected]',
firstName: 'John',
lastName: 'UpdatedDoe',
subscribed: false,
userGroup: 'AlphaUsers',
);

// Example: Find a contact by email
loopsAPI.findContact(email: '[email protected]');

// Example: Delete a contact
loopsAPI.deleteContact(email: '[email protected]', userId: '12345');

loopsAPI.sendEvent(
email: '[email protected]',
eventName: 'AppOpened',
contactProperties: {'platform': 'iOS', 'version': '1.0.0'},
);

// Example: Send a transactional email
loopsAPI.sendTransactionalEMail(
email: '[email protected]',
transactionalId: 'order_confirmation',
dataVariables: {'orderTotal': 50.0, 'productName': 'Widget X'},
);

// Example: List custom fields
loopsAPI.listCustomFields();
}
copied to clipboard


Rate Limiting #
To ensure the quality of service, the Loops API enforces rate limiting. This package includes a backoff strategy, delaying API requests if the rate limit is reached.
Note #
It's recommended to store your API key securely, such as in a .env file.
For more details on API usage and rate limiting, refer to the Loops API Documentation.
Feel free to explore the package, contribute, and report any issues or suggestions!
Contribute here: https://github.com/UntitledApps/loops.so_api