Bursa de Cereale SDK

Acest SDK în Dart este dedicat integrării aplicației Bursa de Cereale în soluții personalizate. Bursa de Cereale este un marketplace digital pentru tranzacționarea directă a cerealelor, fără intermediari, pe piața din România. Platforma oferă transparență, eficiență și o experiență simplificată pentru producători și cumpărători.

Ce face acest SDK?

SDK-ul permite dezvoltatorilor să integreze funcționalitățile cheie ale platformei Bursa de Cereale în aplicațiile lor, precum:

• Gestionarea conturilor de utilizator (înregistrare, autentificare, gestionarea profilului).
• Acces la listele de oferte de cereale disponibile.
• Crearea, modificarea și gestionarea ofertelor de vânzare/cumpărare.
• Notificări în timp real pentru schimbări pe piață sau mesaje noi.
• Tranzacții și istoricul comenzilor.

Caracteristici principale:

• Ușor de utilizat: API intuitiv pentru a accelera dezvoltarea.
• Flexibil: Integrare ușoară în orice aplicație scrisă în Dart/Flutter.
• Documentat complet: Ghiduri detaliate pentru fiecare funcționalitate.
• Suport pentru actualizări: Sincronizare în timp real cu datele platformei.

Instalare

Adaugă acest SDK în proiectul tău Flutter/Dart folosind pub.dev:

flutter pub add bursa_de_cereale_sdk

// main.dart
import 'package:bursa_de_cereale_sdk/cereale_sdk.dart';

void main() async {
 final client = CerealeClient();
 try {
   final auth = await client.login(
      '+40722111227',
      verificationCode: '0000',
    );
   
   print('Token: ${auth['access_token']}');


   // upload image
   final response = await client.uploadImage('./avatar.png', 'avatar.jpg');
   final imageId = response['image_id'] as int;
   print('Uploaded image ID: $imageId');


   // Create listing
  var newListing = await client.createListing({
     'title': 'Grau Premium 2024',
     'description': 'Grau de calitate superioara, productie 2024',
     'price': 1.25,
     'quantity': 5000,
     'category': 'grau',
     'location': 'Cluj-Napoca',
     'delivery_type': 'pickup',
     'moisture': 13.5,
     'protein': 12.8,
     'hectoliter_mass': 78.0,
     'image_ids': [imageId],
     'document_ids': <int>[]
  });

  print('Created listing: ${newListing}');
  if (newListing['id'] != null) {
     final listing = await client.getListing(newListing['id']);
     print('\nListing details:');
     print(listing);
  }
   
  final listings = await client.getListings(
    search: "Premium",
    limit: 5,
    filters: {
      'category': 'grau'
    }
  );

   print('\nListings:');
   print(listings);


   final listings = await client.getListings(limit: 5);
   for (var listing in listings) {
     if (listing['is_favorite'] == false) {
       print('\nFound unfavorited listing ${listing["id"]}');
       
       await client.addToFavorites(listing['id']);
       print('Added to favorites');
       
       var favorites = await client.getFavorites();
       print('Favorites after adding: ${favorites.map((f) => f["id"]).toList()}');

       await client.removeFromFavorites(listing['id']);
       print('Removed from favorites');
       
       favorites = await client.getFavorites();
       print('Favorites after removing: ${favorites.map((f) => f["id"]).toList()}');
     }
   }
 } catch (e) {
   print('Error: $e');
 }
}

Construit pentru a sprijini digitalizarea comerțului agricol din România, acest SDK este o componentă esențială a ecosistemului Bursa de Cereale. Contribuie la dezvoltarea unui viitor mai eficient și transparent în agricultură!