bursa_de_cereale_sdk 1.0.9

SDK for BursaDeCereale.com API

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(
      '[phone]',
      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 doc = await client.uploadDocument('./contract.pdf', 'contract.pdf');
    print('Uploaded document:');
    print('ID: ${doc['id']}');
    print('Filename: ${doc['filename']}');
    print('URL: ${doc['url']}');

    final docs = await client.getMyDocuments();
    print('\nAll documents:');
    for (var d in docs) {
      print('- ${d['filename']} (ID: ${d['id']})');
      print('  Type: ${d['file_type']}');
      print('  URL: ${d['url']}');
      print('  Created: ${d['created_at']}');
    }

    await client.deleteDocument(doc['id']);
    print('\nDocument ${doc['id']} deleted');

   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ă!